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Make something amazing with 
these inspirational builds 
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WELCOME 
to issue 75 


We often say it, but The MagPi is a community magazine. 
Many articles are written by the Raspberry Pi community; 
all our amazing projects are built by the community, 

and every penny we make is ploughed back into ensuring 


T hank you so much for helping us get all the way to issue 75. 


Lucy 
The Raspberry Pi Foundation can train the next generation of Hattersley 
Raspberry Pi makers. Editor of The MagPi. 
i c . Li des, fts, 
We truly couldn't make this magazine without the Raspberry mu der un 
Pi community. You are stars, each and every one of you. Bur dr Ko 
: : 5 1 mangles the piano. 
In honour of this massive milestone, we have been working psc menm 
with the community to choose the 75 Greatest Raspberry Pi that pet dog 


magpi.cc 


projects (page 14). 

It’s an absolute honour to edit The MagPi, but we really 
couldn’t do it without our readers. So let’s all raise a glass to 
issue 75, and look forward to many more issues to come. 


Lucy Hattersley Editor 
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Coolest 
Projects 2019 


A showcase for young innovators, 
Coolest Projects is simply inspirational. 
Rosie Hattersley reports 


ack in 2012, when Raspberry Pi was merely 
a great new idea garnering lots of positive 
praise, another excellent innovation 
aimed at inspiring young creators was also in 
its infancy. 

Coolest Projects (coolestprojects.org) began 
in Ireland as a science fair and forum for like- 
minded inventors to meet and show off their 
ideas. Founded by CoderDojo volunteers Noel 
King and Ben Chapman, the event has gone from 
strength to strength, with thousands of young 
scientists and technologists attending Dublin's 
annual Coolest Projects showcase each year. 


The event is not just about 
the creativity, innovation, 
and sheer effort that 
everyone puts in, but the 
sense of community 


This year, Coolest Projects came under the 

wing of The Raspberry Pi Foundation, with 

events in Ireland, the UK, and North America. 
These locations will be hosting Coolest 


During Coolest Projects, 


Projects fairs again in 2019, according to The kids get to show off the 
i P "T n amazing projects that 
Raspberry Pi Foundation CEO Philip Colligan. they've built 


06 magpi.cc Coolest Projects 2019 dates announced 


Coolest Projects North America will be held 
at The Discovery Cube, Orange County on 
Saturday 23 March, while RDS in Dublin takes a 
turn to host on Saturday 5 May. Ahead of both 
these showcases will be the UK event, now in 
Manchester at The Sharp Project on 2 March. 

Philip says, “Coolest Projects is where 
thousands of young people showcase amazing 
projects that they’ve built using digital 
technologies. If you want to meet the innovators 
of the future, this is the place to be.” 

For him, the event is not just about the 
creativity, innovation, and sheer effort that 
everyone puts in, but the sense of community. 
If that doesn’t sound like the sort of event a 
Raspberry Pi fan might be involved with, we’re 
not sure what does. 

Registration for all three events opens in 
January. Milan, Belgium, and Bulgaria will also be 
holding community events that will run roughly 
concurrently with the Coolest Projects science 
fairs next spring. El 
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4D Arcade Machine: 
Cant Drive This P 


A Raspberry Pi-powered arcade display with hidden 
interactive controls won over the crowds at Gamescom. 
Rosie Hattersley and Rob Zwetsloot got the inside scoop 


wow the crowd at the Gamescom video games 
trade fair, a Raspberry Pi is a surefire way of 
getting you noticed. And that's the way Pixel Maniacs 
went about it. 
The Nuremberg-based games developer retrofitted 
an arcade machine with a Raspberry Pi to showcase its 
: . intentionally silly Can't Drive This precarious driving 
Pixel Maniacs game (magpi.cc/TphZao) at Gamescom. 
. PET Complete with wrecking balls, explosions, an 
Pixel Maniacs is a d s i 
Nuremberg-based inconvenient number of walls, and the jeopardy 
games maker that of having to construct your road as you negotiate 


started out making your way, at speed, across an ocean to the relative 
mobile apps. These 


| f you’re going to add a little something extra to 


Machine creator Pixel 
Maniacs usually makes 
PC and console games 


i M safety of the next lump of land, Can't Drive This 
ays it specialises k : 

in games for is a fast- paced racing game. 

PC, Xbox One, 

PlayStation, and Splash action 

Nintendo Switch. f ; : 

You Can't Drive Pixel Maniacs then took things up a notch by 
This is its first foray providing interactive elements, building a mock 
into gaming with a 4D arcade game (so-named because they feature 


Raspberry Pi. 


pixel-maniacs.com 


VEL THIS; 


p 


eue. Ww 


b This two-player 
co-operative game 
involves one player | 
building the track while i 
the other drives along it 
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A Raspberry Pi is used 
to power the retro-tastic 
256-LED display 


The 1980s arcade 
machine was 
originally destined 
for the dump 


Several Gamescom 
attendees tried to 
buy the project on 
the spot 


Can't Drive This involves one 
player building a road, while 
the other drives it - fast! 


Players receive 
a customised 
memento of 
them playing on 
the machine 


The company's 
first game was 

puzzle-shooter 
ChromaGun 


The team's next 
project sees 
them play around 
with time 
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> Having played your 
heart out, you get a 
photo-booth-style 
shot of you in full-on 
gaming action 


A. Getting to the heart 
of the matter and 
replacing the original 
1980s kit with modern- 
day processors and 
Pi-powered additions 


> The schematic for the 
4D arcade machine, 
showing the importance 
of the Raspberry Pi as 
a controller 


interactive elements such as motion cabinets). 
The fourth dimension in this case saw the 
inclusion of a water spray, fan, and console lights. 
For its Gamescom debut, Pixel Maniacs presented 
Can’t Drive This in a retro arcade cabinet, where 
hordes of gaming fans gathered round its four-way 
split screen to enjoy the action. 

Adding Raspberry Pi gaming to the mix was 
about aiding the game development process as 
much as anything. Andy Holtz, Pixel Maniacs’ 
software engineer, told The MagPi the team wanted 
an LED matrix with 256 RGB LEDs to render 
sprite-sheet animations. 
“We knew we needed a 
powerful machine with 
enough RAM, and a huge 
community, to get the 
scripts running.” 


YOUR SCORE 
7824 
24.08.2018 16:58 
Loot' Pickup al 6:30pm 
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Pixel Maniacs’ offices have several Raspberry Pi- 
controlled monitors and a soundboard, so the team 
knew the Pi’s potential. 

The arcade version of the game runs off a 
gaming laptop cunningly hidden within the 

walls of the cabinet, while the Raspberry Pi 
delivers the game’s surprise elements such as 
an unexpected blast from a water spray. A fan 
can be triggered to simulate stormy weather, 
and lights start flashing crazily when the cars 
crash. Holtz explains that 
the laptop “constantly 
sends information about 
the game’s state to the 
Raspberry Pi, via a USB 
UART controller. The 
Pi reads these state 
messages, converts it, 
and sends according 
commands to the fans, 
water nozzle, camera, 


M! © 


BAMES gamescom 
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Arcade gaming reimagined 


A Raspberry Pi 3B* was used to trigger the 
water spray, lights, and fans, bringing an extra 


and the LED light matrix. So, when players drive 4 Pixel Maniacs J 

x ; reprogrammed a element to the gameplay, as well as rendering the 
through water, the PC sends the info to the Pi, and hand-held games m sed nS SE 
[the latter] turns on the nozzle, spraying them.” console controller for oue: 


$ - : the arcade machine 
The arcade idea came about when Pixel Maniacs 


visited the offices of German gaming magazine 

M! Games and spied an abandoned, out-of-order 
1980s arcade machine lurking unloved in a corner. 
Pixel Maniacs set about rejuvenating it, Da Doo Ron 
Ron soundtrack and all. 


Sustained action 

Ideas are one thing; standing up to the rigours of 
a full weekend's uninterrupted gameplay at the 
world's biggest games meet is something else. 
Holtz tells us, *The Raspberry Pi performed like a 
beast throughout the entire time. Gamescom was 


The transformation from a decidedly unloved- 
looking eighties console to a modern 4D 
gaming machine owes a great deal to the team's 
imagination, as well as the additions the Raspberry Pi 
made possible. 


m The Raspberry Pi delivers the game's 
surprise elements such as an unexpected 
blast from a water spray Ej 


open from 9am till 8pm, so it had to run for eleven 
hours straight, without overheating or crashing. 
Fortunately, it did. None of the peripherals 
connected to the Pi had any problems, and we did 
not have a single crash.” 

Fans were enthusiastic too, with uniformly 
positive feedback, and one Gamescom attendee 
attempting to buy the arcade version there and 
then. As Andy Holtz says, though, you don't sell 
your baby. Instead, Pixel Maniacs is demoing it 
at games conventions in Germany this autumn, 
before launching Can't Drive This across gaming 
platforms at the end of the year. m 


03 Can't Drive This is every bit as engaging and 

frustrating to play as other driving arcade games, 
but this one comes with the unexpected jeopardy of 
getting blasted with water for your troubles. 
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The Knitting 
Network Printer 


What can you do with a vintage 1980s knitting machine? You can 
turn it into a ‘Knitting Network Printer’, that's what! Nicola King 
picks up her needles and probes a very crafty hack 


spanned the decades, but Sarah Spencer has us p à Wy VER. Bei a, 

arguably propelled that craft well and truly D d 
into the 21st century, using her ingenuity, a slightly 
dated piece of knitting equipment, and a Raspberry 
Pi. Sarah has made a hobby of turning a dusty old 
domestic knitting machine from yester-year into 
something very special: a Knitting Network Printer 
that can produce some rather amazing FOs (that's 
knitting terminology for ‘finished objects’ for the 
non-knitters among you.) A cen is 


K nitting is an ever popular pastime that has 


Sarah Spencer 


An Australian 
software engineer, 
Sarahisalsoa § © P — Mill usd 


keen maker and Knitting: 21st century style 
crafter who sele Sarah’s interest in hacking domestic knitting 
her creations in an : 
Etsy shop. machines began several years ago. As a software 
magpi.cc/fvCnbX engineer, she was keen to investigate the possibilities l l 
of marrying current technology with old, and OctoPrint for 3D printers, another popular 
her 1980s Brother KM950i knitting machine (no application for Raspberry Pi.” 
longer in production) has undergone something Taking several years to perfect, Sarah has made 
of a transformation over the past few years. The various modifications to her machine over that 


time, and explains, “With 
the addition of a motor arm 


m When I first picked up a Raspberry Pi, aidan CORN UN 


W Sarah modified a f | | | changer, my knitting 
io, domes | never imagined in my wildest dreams is geting very close 1o 
i a i ! i j i eing hands-free.” The 
a TM. what I'd end up doing with it EZ ea a Mee 
and sends them to it 
via the floppy drive become much larger since 
m E original machine came with an on-board scanner she began tinkering, as Sarah adds that she has 
J E to scan knitting patterns, and a floppy drive to back “specialised in knitting multicolour work using a 
them up. Sarah explains, “By using a floppy drive double-layered technique called double jacquard 
emulator written in Python and a web interface, which requires two beds of needles." 
I can send an image to the Raspberry Pi over the Sarah’s approach is nothing less than practical: 
network, preview it in a knitting grid, and tell it to “I made a thing that can make things, so I need to 
send the knitting pattern to the knitting machine via make something with it, right?" The items that she 
the floppy drive port [...]. I call this setup OctoKnit, has made are impressive, including laptop covers 
in honour of a more famous and widely used tool, and scarves that she sells via an Etsy store. 
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magpi.cc/VaTNeL 


‘Stargazing’ was 
commissioned by 
the EMF festival 


j 7 ; d J E i Its planets are 
ae wera cee Meare oa ee j ER BÓ ^ aligned for the EMF 
DCN. NI X nce ER opening time 
Sarah makes 
The wavy line through the P us personalised knits 
centre is the Earth's equator to order via Etsy 
projected out into space 


ANGULUM 
St RALE 


cr APUS 


Featuring 88 constellations, 
Sarah's stellar map is 4.6m 
wide and weighs 15kg 


Gs * 


CAMELOPARDUS 

ee 
Her piéce de résistance, however, is i Ez $ 
extraordinary and on a very different scale... i 


Stargazing: a knitted tapestry (magpi.cc/ZsvAjA). 


Out of this world 
A huge undertaking that is 15ft (4.6m) in width, 
this celestial map of the night sky features all 88 
constellations across both northern and southern : d i 
hemispheres. Sarah explains that this heavenly i : M... j PEGA i Si oc. i E 
piece of work was “knitted in seven panels E X wed EQ = saira 
stitched together by hand. The pattern on the i ap j - 
Raspberry Pi is 21 times bigger than the memory 
available on the vintage knitting machine, so it's 
knitted in 21 separate but seamless file transfers. 
It took over 100 hours of work, and weighs 15 kg." 
“When I first picked up a Raspberry Pi,” says 
Sarah, “I never imagined in my wildest dreams 
what Pd end up doing with it.” Well, she's done 
something pretty amazing with it, and whether 
you’re a knitter, hacker, or simply an admirer of preted fo a 
cleverness, knitting never looked so good. hackathon in Australia 
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GREATEST 
RASPBERRY PI 
PROJECTS 


We celebrate 75 issues of The MagPi with 
75 amazing projects from around the community! 


couple of years ago The MagPi builds - more than enough to showcase 
A hit 50 issues, so we thought 75 more amazing projects! 

we’d celebrate by putting As we’re the community magazine, 
together a list of the best 50 projects we wanted the community to have a say 
ever made. In the short amount of time in this list, so the top 50 projects on this 
between then and now, the Raspberry list were voted for by you, the readers. 
Pi community has gone above and Read on to find out what you folks think 
beyond and created some incredible is the best project of the last two years... 
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Amazing A 
Projects 


Eben Upton picks his five 
favourite Al projects 


e’ve seen an explosion of 
W projects that make use 
of AI in the Raspberry Pi 


community over the last year or 
so, and while we like to think we 
helped to kick-start this with the the Birthday Party, so it was 
AIY Projects issue of The MagPi, great to see it rising like an 
the community has run far beyond Real-time engine Al-powered phoenix from 
that initial kit. Eben tells us his management the ashes. 
favourite AI projects that he’s seen. 


Zoe and Hermione 


Autonomous drones 


> Andy Baker 
> pidrone.io 


I was there for Andy’s 
flammable drone demo at 


Adam Vaughan 
magpi.cc/ZqPXhU 


á ` 
he plastic hand 
really completes As Liam Fraser will attest, I'm 


Ru daftyet a closet petrolhead, so seeing 

people do engine control of any 

sort with a Raspberry Pi is always 

a pleasure. Add in the machine 

learning angle and this is a really Automating 

sweet demo of what you can vegetable grading 

do with Raspberry Pi in a deep- 

embedded environment. Makoto Koike 
magpi.cc/fDeLLK 


My all-time favourite. This 

is a lovely example of an 
individual engineer solving a 
very specific personal problem, 


Th 2 re's Wa | d (8) using Raspberry Pi as a bridge 
Find the elusive Wally between imaging, I/O, and 


s (local) machine learning. 
Solar Pilot Guard 
Making flying safer 


> Matt Reed 
> magpi.cc/LaGzbn 


our product (and Wolfram 
Mathematica) is very exciting. 
I loved the idea of him repeatedly 


I’ve never been a big fan 
of Where’s Waldo/Wally/ 
whoever, so using machine 


> Foale Aerospace, Inc 
> magpi.cc/fHoUra 


Eben Upton learning to automate the Like a lot of people at Pi flying his aeroplane unsafely 

NNUS process of completing (and Towers, I'm a massive space in order to gather enough 

DEN discarding) each book is very cadet, so learning that training data for the machine 
appealing to me. Michael Foale has been using learning algorithm. 
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Stunning Art 
Projects 


Liz Upton shows US Sound Fighter You must defeat " 
: | ; Hadoukens in D minor Mery 
five projects using Pi 


> Foobarflies 
> magpi.cc/fZxPGD 


to make art 


s more people grow 
A up with accessible 
computing technology, 


we’ve seen many more art 
projects incorporate computers 
and technology in some way. Liz 
tells us some of her favourite 
examples of these arty projects 
in the intersection of STEAM. 


Drop Pi 
Automated water 
droplet photography 


Not just one of my favourite 
creative projects for the Pi, 
but probably my favourite 
project of all time. Two > David Hunt 
pianists play music, which > magpi.cc/fvNmeA 
also controls the angry people 
in Street Fighter. 


An oldie but a goodie: less than 
a year after the first Raspberry 
Pi was released, we started 

to see it being used as a piece 
of inexpensive photographic 
hardware. Dave Hunt’s gorgeous 
water droplet photography uses 
the Pi to coordinate a solenoid 
valve and camera shutter to 
stunning effect. 


Joytone 


Anew instrument 


> David Sharples 
> magpi.cc/XxbZSE 


A completely new musical 
instrument, built around a 
hexagonally isomorphic layout 
which ensures that musical 
structures will have the same 
shape in whatever key they're 
played. Revolutionary, clever, 
and really satisfying. 


Amazon rainforest 


simulator Night in the museum 


The Workers 
afterdark.io 


Poopi & Piter 
magpi.cc/ZhEiVV 


urejg o3e1 'UMYSOW Áoxely 31po12 


What's creepier than a locked 
museum after dark? A locked 


| wrestled a bit here. Does this 
fall under creative projects 

or conservation? | reckon it 
ticks both boxes: it's a simply 


museum after dark full of robots, Liz Upton 
that's what. This project allowed 


beautiful object I could stare at people to look through the eyes Director of 
for hours, as well as a working of wandering robots in Tate etal 
Amazonian wildlife habitat. Britain after the witching hour. EROA a d 
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CoderDojos 
Coolest Projects 


Young makers at CoderDojos make amazing things too 


e’re taking a break from showing you just 
W amazing projects to also highlight some of the 

coolest creations from the CoderDojo’s Coolest 
Projects events! These events feature amazing projects 
created by young makers from CoderDojos around the 


globe. Here are five incredible ones, but there are many 
more you can find at coolestprojects.org. 


Supporting refugee communities 


Jeroen magpi.cc/GhdBjg 

In the winter of 2016, many refugees were making their 
way to Europe. To try to help them adjust to their new 
homes, the then 15-year-old Jeroen decided to make an 
app for them. 

"I had the opportunity to talk to refugee assistance 
organisations in Belgium and France," says Jeroen. “They 
were enthusiastic to help me and they also gave me 
inspiration on the content and the conversations in the app.” 

Jeroen's story found its way to local and international 
news, and he won the Future Makers category at Coolest 
Projects 2017. 
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Light up my helmet 
Enlightened bike safety 


> Kobe 
> magpi.cc/vcipGF 


because it is much safer in case 
you would fall or crash.” 

As well as the helmet being 
decked out in a load of LEDs, 
and a battery to power it, Kobe 


Kobe is an avid cyclist, and 
he cycles to school every 

day. This means that fora 
good portion of the year, he’s 
cycling in the dark. “Making 


m Making something that makes 
you more visible in traffic would 
be a good improvement EJ 


has installed a wireless remote 
control on the handlebars so 

he can activate indicator lights, 
much like you see on a car. 


something that makes you 
more visible in traffic would 
be a good improvement," he 
says. “I always wear a helmet, 


Amy's Buzzy Hive 


Save the bees 


> Amy 
> magpi.cc/RaUYPd 


“Malvina, one of our mentors, 
said ‘Wouldn’t it be great 
to do something to help the 
environment?"" recalls Amy. 
*Another mentor keeps 
bees and said that the bee 
population is in danger (and 
that means no honey!), so I 
decided to do a project on a 
way to maybe find out why.’ 
Amy’s project uses 
several sensors hooked up 
to a Raspberry Pi inside a 
beehive, which tracks bees’ 
numbers in an attempt 
to identify the cause of 
dwindling populations. 


? 
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Donate Hair for Cancer Wigs 
Helping sick kids 

> Andrea > magpi.cc/WZLCPC 

Andrea's project takes the form of a short story that the 
Seven-year-old created in Scratch. Andrea wanted to share 
the message about how donating hair can help out young 
patients who have cancer. 

"Coolest Projects 2017 was the perfect place with so 
many kids attending from all around the world,” says Andrea. 
"| was hoping that they can see my project and to accept 
this cool idea for supporting kids with cancer." 


The Lost World 


A post-apocalyptic game 


> Matei > magpi.cc/kXcAdm 
Ten-year-old Matei loves science fiction, 
and came up with the idea for his game after 
reading some books set in a post-apocalyptic 
world. Instead of the usual gloomy setting, 
Matei’s game has a more hopeful outlook for 
humanity’s future. 

To create the game, Matei taught himself how 
to use the Unreal Engine, with some help from 


mentors at his local CoderDojo. An amazing 
achievement at age ten, which earned him the 
prize for the best Games Under 12 award. 


Raspberry Pi Foundation 
CEO Philip Colligan got a 
chance to see the project 


re 
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Projects 
for Good 


Philip Colligan reveals his top-five 
world-changing Pi projects 


s well being an amazing computer for learning, 
the Raspberry Pi is a powerful force for good. From 
environmental protection to healthcare and citizen 


science, folks around the world are doing remarkable 
things with our favourite single-board computer. CEO of 
The Raspberry Pi Foundation, Philip Colligan shares his 
favourite projects with us. 


Telemonitoring and drying of diabetic foot ulcers 


Ernesto Holguin otenmedical.com 
We met Ernesto Holguin 

from El Paso in Texas at the 
Houston Maker Faire, showing 
off his fantastic Diabetic Foot 
Health machine. It utilises the 
Raspberry Pi 3 to inspect feet, 
dry them, take images, and 
communicate other vital sign 
information with clinicians and 
family members. One in five 
diabetic patients visit a clinic 
about ulcerative wounds, and 
this machine improves the 
frequency of skin monitoring. 


Philip Colligan 


CEO, The Raspberry 
Pi Foundation 
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Do-it-yourself 
wireless networks 


Mazi 
mazizone.eu 


Arribada 


Harnessing green sea 
turtles for conservation 


Mazi uses Raspberry Pi to 
create hyperlocal wireless 
networks that are being used 
by communities from Athens to 
Zurich to fuel social innovation 
projects. Mazi was just one of 
the Pi projects that | saw on 

a recent visit to the amazing 
Knowledge Media Institute at 
the Open University. 


» Alasdair Davies 
» blog.arribada.org 


Arribada is the latest initiative 
from the amazing Alasdair 
Davies, a technologist, 

Pi enthusiast, and 
conservationist who is on a 
mission to make low-cost 
conservation technologies. 
Alasdair has created a turtle 
tag using Raspberry Pi Zero W 
and Camera Module that 
literally allows us to travel 
with the turtles. Amazing. 


Fesentience 


Tackling neonatal 
abstinence syndrome 


Project Rover 


Semi-autonomous 
bomb disposal 


» Engineering and Science 
University Magnet school 
(ESUMS) 

» magpi.cc/BikRuh 


» Staff Sergeant Jolley, 
Sergeant Rana, & 
Sergeant Paddon 

» magpi.cc/cbRVjY 


The team at Fesentience 
is using the Raspberry Pi 

to create a product that 

can mimic the maternal 
womb to help babies born 
with neonatal abstinence 
syndrome. A great example 

of Pi powering innovations 

in healthcare, which I predict 
will be one of the most 
exciting fields for applications 
of the low-cost computer in 
the next few years. 


This brilliant use of a Pi came 
out of a British Army Foreman 
of Signals training programme. 
What I love about it is that 

the three soldiers behind 

the invention had limited 
programming experience, but 
were able to quickly develop 

a robot that could sense and 
avoid obstacles. 
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CDP Studio is a development platform for industrial control systems, now coming with a free 
version for non-commercial use. The system can run on a Raspberry Pi, supports C++, open source 
libraries and has a large feature toolbox including GPIO, I2C and MQTT. Its built in GUI design tool 


and features lets you code less and do more. 


Free download on 


CDP Technologies AS 
Nedre Strandgate 29 

P.O. Box 144 

NO-6001 Alesund, Norway 


Tel: +47 990 80 900 
info@cdptech.com 
www.cdpstudio.com 


CDPStudio 
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Projects 


Carrie Anne Philbin with five 
amazing uses of Pi for learning 


earning is right at the heart of the Raspberry Pi 


experience, and an uptake in education was the driving 
force behind the board’s original development. The 
Raspberry Pi Foundation’s Carrie Anne Philbin selects her 


favourite educational projects. 


Crumble bot 


An inexpensive and 
easy-to-control robot 


> Crumble > magpi.cc/GxBVTM 


Raspberry Pi Certified Educator Nic Hughes 

introduced me to Crumble bots at a conference. 
Redfern's Crumble board is inexpensive and easily 
programmed using a block-based interface. It has been 


designed with young children in mind, connecting easily to 


motors using crocodile clip cables. Students typically start 


with simple forwards and backwards motion, before facing 


the challenge of figuring out how to make their robots turn 


left or right. Design skills are used to build a stable and useful 


chassis. Of course, anything can be a chassis: my Pringles 
tube Crumble bot is just one example. 


Carrie Anne 


Philbin 


Director of 
Informal Learning 
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E interested in computing. 


MOONHACK 


Moonhack 


Breaking the code 
world record 


> Code Club 
> moonhack.com 


Moonhack is Code Club’s free 
world-record-setting event 
for kids aged 8-18 around the 
world. Held on 20 July (the 
anniversary of the Apollo 11 
Moon landing), it entails kids 
all over the globe getting 
involved with coding projects. 
Every year it gets bigger, and 
Moonhack 2018 saw 35 865 kids 
from 58 different countries 
taking part. 


Digital Maker 
Staged Activity 
Badge 


Making with the Scouts 


> Scouts 
> magpi.cc/VgdkKij 


Getting digital making into kids 
hands is what the Raspberry 

Pi Foundation is all about, and 
the new badge activities we 
developed with the Scouts are 

a fantastic way to reach out 
to more children who may be 


Qe 


u 


Agrihack 
Solving farming problems 
with a Raspberry Pi 


» Agrihack 
» magpi.cc/BSrjpg 


Agrihack brings together 
Australian children, coders, and 
farmers to solve problems with 
technology. The Hackathon 
challenges are: reducing 

stored grain spoilage from 

high moisture, measuring the 
live weight of meat chickens 

to prevent overfeeding, and 
assisting the handover of farms 
and fisheries from the older to 
the younger generation. 


BBC Computer 
Literacy Archive 


A golden era of computer 
education projects 


» BBC 
» magpi.cc/nqHDem 


If you've ever wanted to know 
more about the history of British 
home computing. a whole 
treasure-trove of interviews, TV 
shows, programming code, and 
photos has been assembled for 
your delectation and inspiration. 
The BBC's archive of its 
Computer Literacy Project (CLP) 
is packed with professional 
educational resources from a 
ten-year endeavour to teach 
the nation computer skills. 


` DINrPlate" 


The simple way to mount your Pi! 


En 41 


Industrial DIN rail mount 
e Open frame for better airflow 
Integrated USB strain relief 


Pi Zero.version 
Y rr 


www.DINrPlate.com Oe 
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READER VOTED 
PROC IS 


A voted for by you, the readers, 
here are 50 Raspberry Pi projects 


Hoverbot 
A robot made from a hoverboard 
and an old table 


» [Isabelle Simova 
» magpi.cc/CDEbOq 


While countless Raspberry Pi robots 
have been created, most of them 
are on the small side. Hoverbot, 
however, bucks this trend and 
comprises upcycled parts including 
a hoverboard and an IKEA table. 
Hoverbot is a large robot that is 
equipped with sonar sensors for 
obstacle detection and is powerful 
and sturdy enough to transport 
heavy items and even people. 
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QBee 


The dress that awards 
points for social interaction 


> Clodagh O'Mahony 
> magpi.cc/xUoouA 


For her thesis project, Clodagh 
created a dress and an 
accompanying website to 
comment on the progression 
of social media interaction. 
Clodagh created a corporation 
named Bee. an abbreviation 
of Queen Bee, with the 
associated honeycomb theme 
playing a significant part in 

the look of both the dress and 
website. This corporation, if 
given true life, would provide 
a range of wearable tech 

- similar to her dress - that 
would allow for the recording 
of social interaction data, 
updating it to the wearer's 
online QBee account. 


Dog Treat Machine 
With motion detection 
and video capture 


> Eric Page 
> magpi.cc/2sTf5qU 


While pondering what to get Shirin, his fiancée, for her birthday, 
Eric Page realised how much she misses her dog Pickles while 
she’s at work. He decided to build a Dog Treat Machine to allow her 
to serve treats to Pickles remotely. There are four ways to trigger 
the Pi-powered device: email, MQTT, IFTTT, or Alexa. It then plays 
a sample of Shirin’s voice, dispenses some dog treats, and checks 
for motion using OpenCV analysis. 


Museum in a Box 
Experience artefacts 
from afar 


» Museum in a Box 
» museuminabox.org 


Pop a museum object on 

top of the box and it will 
start telling you about itself. 
Through 3D- printed models 
and wooden sculptures, 2D 
images such as postcards 
and photography, and 'do 

it yourself? feedback cards, 
the team aim to break the 
disappointing, yet often 
necessary, Do Not Touch 
stigma of museums, allowing 
everyone the chance to get to 
grips with a history they may 
otherwise miss out on. 


An underwater 
weather station 


Diemo Niemann 
save-nemo.org 


For the past two years, the Save 
Nemo Foundation has worked 
hard to protect coral reefs off the 
coast of Thailand and Indonesia. 
Its members have been sinking 
concrete blocks next to the 
reefs, allowing diving and 
snorkelling boats to safely moor 
by using them as anchor points. 
Nemo Pi is a smart buoy able to 
measure temperature, visibility, 
pH levels, and the concentration 
of CO, and nitrogen oxide at 
each anchor point. 


MonomePi 


A music box featuring old 
and new technology 


» Joon Guillen 
» magpi.cc/uDPImr 


With hammers hitting the bars 


of a toy glockenspiel to play a 
tune, the Monomepi sounds 
just like an old-fashioned 


music box, but this Pi-powered 


contraption is based on new 
technology... and quite a 

lot of Lego. The Monome is 
connected to a Raspberry Pi 3 
running a step sequencer 
program, which registers the 
user's button presses on the 
Monome and lights them 

up accordingly. 


Tomy Turnin' Turbo 
Dashboard Qut Run 


Classic video game in a toy 


» Matt Brailsford 
» circuitbeard.co.uk 


Matt Brailsford, picked up a Tomy 
Turnin’ Turbo Dashboard on eBay 
and had a spark of genius: why not 
turn it into a fully working Out Run arcade machine? Matt 

tells us it's fun to play. “It was a little squeaky to start with, but I 
had just tightened everything up a little too much. It runs nicely and 
brings back those memories as a kid. It's how I thought it felt to play 
with back then." 


This robotic fish swims 
with real ones 


Robert Katzschmann 
magpi.cc/kjsBkZ 


In the depths of the South 
Pacific, a strange new fish is 
exploring the Rainbow Reef. 
Flexing its tail from side to side 
to propelitself serenely along, it 
captures the underwater scene 
using a camera - with a fish-eye 
lens! - mounted in its head, 
which also contains a Raspberry 
Pi 2, among other electronics. 


Trading card scanner/organiser 


Using Lego to scan card collections 


> Michael Portera > magpi.cc/YyscOC 


Michael envisaged a simple system that would spin and 
push preloaded cartds forward to be photographed and 
uploaded for digital storage and processing. The idea was 
to make light work of organising and valuing even the 
largest of collections. 


C-Turtle 


This mine detector could save lives 


> Kevin S Luck > magpi.cc/2yzh4pu 


It's a sad truth, but right now the world is littered 
with an estimated 110 million land-mines. C-Turtle 
uses machine learning to figure out how to walk 
across the most unusual and hazardous of terrain, 
constantly adapting to its surroundings. 
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Magri 


A better baby monitor 


Dmitry lvanov 
magpi.cc/2jy01vO 


This advanced baby monitor 
was created due to frustration 
with the limitations of 
commercial baby monitors. 
Dmitry originally put all the 
pieces in a lunchbox before 
upgrading to a custom case 

- it includes a microphone, 
an IR camera, and can be 
accessed via a web browser. 


Pi-powered takeaway 


» Ehsan Rahman 
» magpi.cc/2mFCdZB 


Automation is easy with a 
Raspberry Pi, and Ehsan 
decided to use it to create an 
order system at his father's 
restaurant. It connects to 
some tablets which waiters 
use to take orders, and they're 
then printed out via the 
Raspberry Pi. 


3D Pac Robot Man 


A real-life classic 
> Emanuele Coletta > magpi.cc/FFVwSt 


Pac-Man is a timeless classic that has been remixed and 
remade in many ways, including cult-classic Pac-Man Vs. In 
this edition of the game, one person controls Pac-Man in the 
maze, while friends control the ghosts and try to stop them. 
Emanueles version takes the concept one step further by 
creating the maze and characters in real life using robots. 


Recreates the joy of using a Polaroid 
Toby Hendricks magpi.cc/tcGRGh 


Toby, aka musician Otem Rellik, was frustrated with 
iPad music apps. So he decided to make his own 
using a Pi Zero and the Pure Data programming 
language. What started out as an experiment turned 
into a wonderful-looking, multifunctional synth. 
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Who you gonna call? 


Anthony Dipilato 
magpi.cc/bLPSrp 


Anthony’s Ghost Detector 

is actually a present for his 
father, an avid watcher of 
paranormal investigation 
shows. It started off as an 
electromagnetic field meter, 
but an IR camera was added 
to the build. While the case 
resembles wood, it's actually 
3D- printed. 


What started out 

as an experiment 
turned into a 
wonderful-looking, 
multifunctional synth 


Instagif NextStep 
The printable GIF 


> Abhishek Singh 
> magpi.cc/2yKkc1T 


This fun project obviously 
doesn't print a moving image 

- instead, Abhishek has made 
it so that a very short video is 
uploaded to a cartridge which 
looks like a Polaroid picture 
and houses a small screen. 
You insert the cartridge into the 
front of the camera and it spits 
it out once it's ready. 


Automated libations 


Stefan Hóving 
magpi.cc/uiTVEP 


While making a cocktail by 
hand can be fun (especially 
when you fudge the 
measurements), it's also 

very cool to be able to have a 
cocktail dispensed straight 
into a glass. It's all a bit Star 
Trek. We especially like the 
classy presentation of this Pi- 
powered booze maker. 


MägPi 


Play chess against a robot 


Joey Meyer 
raspberryturk.com 


The Mechanical Turk was 

an old parlour trick where a 
chess master would sit in a 
box and control a dummy so 
it looked like it could play 
chess automatically. The 
Raspberry Turk is not a trick: 
it’s an actual robot you can 
play chess against. And that’s 
pretty cool. 


Aphex Twin 
Midimutant 


An evolving synthesiser 


> Dave Griffiths & Richard James 
> magpi.cc/hptLSQ 


' ge 


Instead of manually programming 
a synth yourself, the Midimutant 
runs through endless combinations 
to create a new series of synth 
sounds through code mutations 
and mixing. After a couple of hours, 
it usually produces something that 
sounds good. 


What can't this robot do? 


Ahmed Al-Faris 
magpi.cc/PKaxfz 


Raspberry Pi robots can be 
expanded and built upon quite 
a lot, but we've never seen a 
robot with this many functions. 
It has a manipulator arm, five 
control methods (including 
autonomous), video streaming, 
Alexa voice interaction, 
obstacle avoidance, and can 
even do order picking. A true 
renaissance-bot. 
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Recreates the joy of using a Polaroid 


Pierre Muth magpi.cc/beJzih 

We've seen many digital camera builds using the Raspberry 
Pi and Pi camera. From 3D- printed cases to retrofit vintage 
classics, the majority act as simple point-and-shoot 
camera. The PolaPi-Zero, however, takes its lead from the 
iconic Polaroid, utilising a thermal printer within its body 
to deliver instant prints of your subject matter. 


Pi Film Capture 
Converting old film 
reels to digital video 


» Joe Herman 
» magpi.cc/AfykKA 


Restoring home movies 
captured on film can 

be a real challenge. 

Film conversion is a time- 
consuming and often 
expensive task. One maker, 
Joe Herman, took matters 
into his own hands by 
hooking up a Raspberry 
Pi Camera Module to 

an old projector. 


Teletext makes a comeback 


Peter Kwan magpi.cc/qGYOkS 

We're delighted that teletext has been revived by the 
Teefax project. Users can install the free software 
(magpi.cc/2dssVeo) on a Raspberry Pi, connect its 3.5mm 
video output to a TV (via the SCART socket), then hit the 
teletext button on the remote control. 
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Seeing Wand 


It speaks an item's name 


» Robert Zakon 
» magpi.cc/kKzCmJ 


Robert Zakon has built a Seeing 
Wand that can speak the name 
of whatever it's pointed at. 
Housed in a makeshift PVC 
tube, a Pi Zero is connected 

to a Camera Module that 


takes a photo when a push- 
button is pressed. The image 
is sent to Microsofts Cognitive 
Services Computer Vision API 
to get a description. which is 
then spoken. 
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Scientific study aid 


Giorgo Gilestro 
magpi.cc/2i3vTHt 


When a group of researchers 
looked for a low-cost way 

of conducting studies in 
neuroscience, they turned to 
our favourite computer. The 
result is a machine with the 
potential to make ground- 
breaking discoveries about 
common human behaviour. 
And its secret ingredient? 

A load of flies! 


Security Robot 
This robot security guard 
is an arresting sight 


> Josh Starnes 
> magpi.cc/2DNur9h 


Inspired by sci-fi movies such 
as Short Circuit, Evolver, and 
Star Wars, Josh got to work 
on an affordable DIY robot 
that can trundle around the 
streets, operate in cold and 
wet weather, work well in low 
light, and communicate. 


A weaving wonder 
controlled entirely 
by Raspberry Pi 


» Fred Hoefler 
» magpi.cc/eoZTUx 


When Fred Hoefler sent back a 
computer-controlled tabletop 
loom after it stopped working 
with his MacBook Pro, his wife 
Gina suggested that he should 
be able to build one with *one 
of those Raspberry Pi things 
of yours." Fred recalls, *The 
most reasonable answer I 
could come up with was: ‘asa 
matter of fact, I think I can.’” 
A project was born. 


Little Green Tower 
An aeroponics tower that 
grows some tasty veg 


» Chris Johnson 
> magpi.cc/GDOzUk 


*For the last five years I 
have been designing and 
refining an aeroponics tower 
system that is particularly 
well-suited to growing leafy 
green vegetables," Chris tells 
us. “The goal is to design 

a computer-controlled, 
modular, compact, and low- 
cost aeroponic system that is 
easy to replicate." 


ETT 


Pi Deck 


Digital music can't be scratched 
- orcan it? 


» Daniel James 
» 64studio.com 


Daniel and his colleague Chris 

Obbard at 64 Studio put a Raspberry 
Pi 3 alongside a standard vinyl deck, 
eliminating the hassle and expense of 
hooking digital decks to a laptop. They 
figured that all you need is a USB stick 
packed with music files. *As long as 
there is low latency in both directions 
of travel, you can make effects such 
as rubbing the kick drum beats, 
scratching, and backspins sound, 

feel and look realistic," Daniel says. 


Steampunk Pi Jukebox 


Retro-futuristic music-streaming device 


> Matt Van Gastel > magpi.cc/2CRrL6Z 

Matt has turned the main assembly of a 1930s Westinghouse 
radio receiver into a Pi-powered modern player. He began the 
project by tearing out the innards from the old tube amplifier. 
"| had looked at making an actual tube amplifier, but the cost 
was too high for the quality,” Matt tells us. “But | found the 
JustBoom site and found this HAT fitted the bill” 
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Aquaponic Domestic Garden 
Veg and fish living in harmony 


> Diego Braga > magpi.cc/FLTVFM 

Aquaponics is a bit different from hydroponics - in this method, 
plants and fish co-exist and create their own ecosystem to 
feed each other. The fish fertilise the plants, and nutrients 
from the wet soil drop down into the tank below. 


Ghost in the pawn 


Tim Ness, Alex Angelov, 
& Alex Smith 
magpi.cc/LxbagV 


Chess software is readily 
available these days, so it was 
easy for Tim to get it running 
on a Pi. The real trick was 
inventing a system whereby 
a semi- hidden robotic arm 
moves chess pieces using 
electromagnets, all dictated 
by the chess software. 
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Half-Tesla, Half-Honda, all Pi 


Jim Belosic & Michael Mathews magpi.cc/NiQMmj 
This amazing hybrid uses a Raspberry Pi as an on-board computer 
which monitors the motor and allows you to configure it. It 
features a retro, eighties-style display and uses toggle switches to 
complete the old-school aesthetic. Jim uses it for drag racing and 
it's extremely fast. 


Tetris under coffee 


Andreas Rottach 
magpi.cc/EWRCvg 


We've seen a few tables that 
have displays in them, but 
none that looks like this table 
made by Andreas. You can 
play several games on it, but 
honestly the gaming aspect 
isn't the most interesting - 
it's the custom, giant pixels 
that provide amazing imagery. 


Photo Booth 
DIY wedding photography 


» Jack Barker 
» magpi.cc/2sNsRic 


Photo booths at wedding 
receptions are all the rage at 
the moment. Jack realised he 
could make something better 
with a Raspberry Pi though. 
and created a Pi-powered 
photo booth for his own 
wedding. It even gives you 
posing advice! 


MägPi 


Automated star following 


Mike Hamende 
magpi.cc/MLwYio 


Automatic tracking is 

something a lot of higher-end 
telescopes do, but with a bit of 
know-how and a custom-built 


Lunchbox Arcade 


Burger time or mount, Mike was able to get Pi-powered embroidery 

BurgerTime? a Raspberry Pi to control his 

-———————— telescope. It makes it easier Alessandro Benanti magpi.cc/LpAyYu 

» Daniel Davis to find and then keep specific 

» magpi.cc/Aivheb celestial bodies in sight. Automated embroidery machines that use a computer 


can cost a lot of money, so it's amazing that Alessandro 
managed to upcycle an old sewing machine to do the same 
job for less than £200. It's all automated and uses a Pi to 
control it all. 


When you've already built 

a full-size arcade cabinet. 

the only way to go is smaller. 
Daniel wanted to make a more 
portable arcade device, and 
after purchasing an old metal 
lunchbox, that's exactly what 
he did. 


Sisyphus Table 


Beautiful robotic sand art 


» Bruce Shapiro 
» magpi.cc/2fUUaRN 


We love seeing amazing art projects 
that use the Raspberry Pi - this one is a 
beautiful coffee table that uses a robot 
to create Spirograph-esque patterns 
under the glass. You can even buy one 


yourself, if you have a few grand spare. 


Extraterrestrial forecasting 


Alex Schwarz 
magpi.cc/gpwrsv 


Is there weather in space? 
The short answer is yes, and 
Alex's weather station makes 
use of radio waves to keep an 
eye on it. It ‘listens’ for solar 
wind and any changes in the Beneath the sand surface 
Earth's magnetic field, which Baria estis eats 


n This moves the ball using 
is then tracked by graphs. a powerful magnet 


75 Greatest Raspberry Pi Projects magpi.cc 31 


32 


FM 3-Channel 3-Station 


WIRELESS 
INTERCOM 


Google AIY kit inside an old FM wireless intercom 


Martin Mander magpi.cc/2vPQK6E 
When Martin Mander saw The MagPi was giving away a 
free hardware voice kit from Google in issue 57, he did the 
sensible thing and rushed off to buy a copy. But after he 
assembled the components, placed them in the cardboard 
housing, and pressed the button to activate the Google 
Assistant to ask a question, he started to think about the 
future possibilities. 

“The family and I enjoy the local car-boot sales and 
I’m always looking for old, obsolete, or broken technology 
that I can use in projects," he says, relishing the chance of 
picking up something from the 1970s and 1980s. 


N@AVSIA 


ES 


ade by you 
with Google 
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Wizard Chess 


A fully working Harry Potter Wizard's Chess set 


» Bethanie Fentiman 


Bethanie Fentiman can't play 
chess, but when her imagination 
sparked and the opportunity 
presented itself, she brought 
the iconic game of Wizard's 
Chess from Harry Potter to 

life using a Raspberry Pi. 
Stepper motors, and possibly a 
little magic. 


> magpi.cc/dPjCUk 


For her A-level computing 
coursework, Bethanie took an idea 
that had been nestling in the back 
of her mind, and turned it into a 
reality. Well, as much of a reality 
one can create when the literary 
version includes battling chess 
pieces that leave their opponents 
crushed to rubble on the board. 


Fresh light on the idea of a motion-sensing illuminated mirror 


Roberto Tyley 


On reflection he could have 
just bought a lamp, but after 
Roberto Tyley stood on one 
too many of his children’s 
toys in the dark corners of 
his bedroom, he was hit by 

a flash of inspiration. What 
better way of illuminating 
the room, he mused, than a 
full-length portrait mirror 


magpi.cc/2wVeHNE 


that would shine brightly 
whenever anyone wandered 
by? One with individually 
controllable LED lighting 
that would directly respond 
whenever someone posed 
in front of it, perhaps? As 
light-bulb moments go, he 
admits it was certainly high 
on the wacky scale. 


Project MyHouse 


This smart doll's house features 
gesture recognition 


> Maks Surguy & Yi Fan Yin 
> magpi.cc/sGPTSi 


Maks and Yi Fan conceived the idea of 
this interactive doll's house. Inside this 
cool crib, various features - including 
lighting and shutters - can all be turned on 
and off by the simple wave of a wand' (a 
PlayStation Move controller), with the help 
of some clever coding and a Raspberry 

Pi 3. You can see a demonstration video 

at youtu.be/6EiTWZfPm3k. 

“| thought a smart doll's house would 
be a great tool to demonstrate technical 
innovations to people in an approachable 
way,” says Maks, who worked with Yi 
Fan over a ten-week period, designing 
and constructing the clever little 
doll's domicile. 


-N/hen someone stands 
inside the frame, Take 
Photo is pressed on 

the laptop software, - 


and the images are ` 


captured and saved 
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A relatively inexpensive 
full-body 3D scanner 


Poppy Mosbacher 
magpi.cc/2xRmUjR 


While learning to make her own clothes, 
Poppy Mosbacher bought 27 Pi Zero 
Ws and 27 Camera Modules, 27 Pi Zero 
camera cables, and 27 USB to micro USB 
cables, as well as an assortment of battery 
packs, power regulators, wire connectors, 
and other electrical items. Inspired by 
Richard Garsthagen (magpi.cc/2xVr3Vr), 
Poppy then looked at making the scanner 
affordable and portable. 

“It opens up new possibilities, such 
as of scans of children who won't stay 
still long enough for the single camera 
method; building a personal database of 
scans taken at regular intervals to see the 
effects of aging; and making avatars for 
VR environments." 
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Parts 


> 7-inch display 
> Poster frame 


> Theme park 
memories 


Daily Prophet a 


Pi-powered magic newspaper 


> Piet Rullens Jr » magpi.cc/MQJXKw Í 


Displaying holiday memories is something many of 

us think about. When Piet and Linda returned from 

the Wizarding World of Harry Potter, they had a lot of 
excellent video but nowhere to display it. Instead of 
getting one of those boring moving photo frames, Piet 
decided to take some inspiration from Harry Potter and 


m Instead of getting one of those 
boring moving photo frames, 
Piet decided to take some 
inspiration from Harry Potter m 


create their own Daily Prophet in their living room, 
complete with video display for authenticity. 

*First, I designed the whole poster in Photoshop," Piet 
tells us. ^Within the design, I marked an area with the 
exact size of the Raspberry Pi screen. Next, I plotted the 
poster on normal paper at 100 percent, so the marked 
area still matched the Raspberry Pi screen." 

Piet was able to mount the frame over a small 
cupboard, making hiding the electronics easier. The 
videos have a sepia filter on them to fit in with the 
newspaper aesthetic, and a motion sensor waits for 
someone to come close to it before playing any video. 

A nice power-saving technique. 
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A It displays images 


and videos, much 
like its fictional 
counterpart 


The electronics are 
sneakily hidden 
behind the frame 


Want to learn about 
using omxplayer to 
play videos? 


Check out the documents 
on the GitHub: 
magpi.cc/ABdFRJ 
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PiOcket-Tiny PI 


A tiny gaming Pi 


> Peter Barker > magpi.cc/CDXVIT 


People love to make very small things with the Pi Zero, and 
Peter is no different. After getting all the parts to upgrade 
an old Game Boy into a retro gaming powerhouse, he 
couldn’t bring himself to take the working Game Boy apart 
and decided to make the smallest gaming Pi that he could. 
“Things progressed from there, really,” 
Peter explains. “I didn’t like how big the 
circuit board was for the screen, and 
realised that there weren’t all that many 
bits to it, so I started designing my own.” 
His resulting Game Boy Zero build led 
him to make an even smaller version: 
the Tiny Pi. It uses a1.44-inch screen, 
a five-way joystick, and has two 
push-buttons. You can build one 
yourself with his available AA 
STL files, or using one of 
the kits he’s now selling 
(magpi.cc/byPfTG). 


NE iN © 7 s mm , 


| | D 
|| d'i FRuDURITES 


W ALONE In p | 
M SPACENAN TE 


s À Mh j^ | i | 


.q 
M PICOMRRh ioe 
M TUO HIRING CATS HAVE A 


> Custom PCB 
> 1.44-inch display 
> Pi Zero 


A To get a true sense of 
its scale, here it is next 


Make your own hand-held to a classic Game Gear 
retro gaming device P» Peter designed custom 
using our guide in issue 55: PCBs for his project 


magpi.cc/55 
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Parts 


> Raspberry Pi A+ 

> Adafruit 2.4-inch TFT touchscreen 
> Adafruit Pi Protector case 

> 1000 mAh lithium polymer battery 


b 
A > Velcro wrist strap 


Windows 98 
Watch 


Wind back the clock with this chunky wristwatch 


> Michael Darby » magpi.cc/eYtwCn 


0 Ma ny Years later YOu look back on it If Microsoft had designed a smartwatch back in the 
late nineties, it might have looked something like this! 


and want to relive it. | think time has Michael Darby, aka 3147eactor, has built a chunky, 


Pi-powered wristwatch running the Windows 98 


a funny way of keeping more of the | operating system. 
good than the bad within memory Z0 While he admits the ancient OS used to drive him mad 


back in the day, he has an odd nostalgia for it. *Many 
years later you look back on it and want to relive it. I 
V pee eas DN think time has a funny way of keeping more of the good 
buttons, is mounted on the Pi than the bad within memory." 

Once he'd accrued the required components, including 
a Raspberry Pi Model A*, it only took a few hours to 
put together. He has since written a detailed build 
tutorial (magpi.cc/yXfgmx). 

The watch is powered by a slimline LiPo battery 
connected via a PowerBoost 500 with switch, while Velcro 
feet secure the watch body to a wrist strap. 

Michael has received plenty of positive feedback for 
his Windows 98 Watch, which he wore to Raspberry Pi's 
Fifth Birthday Bash. “The reaction has been crazy; I never 
expected it to take off like it did, but I’m very happy it did 
and it has inspired me to create more and work harder." 


You can learn 
all about 
Windows 


10 IOT Core 
in issue 48: 
magpi.cc/48 
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Parts 


> Raspberry Pi Zero 

> ESP8266 

> Arduino 

> 128x64 1.3-inch OLED screen 
> RGB LED and vibromotor 


A Fancy assembling 
your own smartphone? 
You'll soon be able to 
buy a ZeroPhone kit 


ETT 


Zero Phone 


Turning a Pi Zero into a mobile phone 
> Arsenijs Pióugins > magpi.cc/XAMjks 


ZeroPhone is an open-source project to create a mobile 
phone kit for the Pi Zero. Owners of ZeroPhone will 

be able to make calls and send text messages. It will 
also have basic apps such as an alarm clock, calendar, 
calculator, web browser, and music player. 

Behind the project is Arsenijs Piugins, an 18-year-old 
student from Riga, Latvia. He now has a team of people 
helping him. 

The open-source software approach is “likely to be 
secure and not privacy-invading," says Arsenijs. You can 
disable features you don't like, and it doesn't depend on 
any cloud services. You will be able to install firewall, I2P, 
and TOR nodes, as well as secure messenger services. 

“It’s open-source, Linux-powered, and you can make 
one yourself for $50," he says. Since the project first 
appeared in The MagPi, Arsenijs has taken the project to 
Crowd Supply for funding. 

*For me, this project is a huge undertaking that, if 
done right, will influence the way we perceive mobile 
phones,” remarks Arsenijs. He explains that it will help 
solve privacy and security concerns, as well as allow us to 
develop better open-source GSM technology. It will also 
help power mobile phone hacks. 

“Besides, this is an open-source Linux-powered phone 
you can independently assemble for less than $50," 
observes Arsenijs. “That’s pretty cool.” 


<4 ASIM800 GPS module 
and antenna are used 
to connect to the 
mobile phone network 


E d You can connect 
LE 3 a Raspberry Pi to a 
+, ; : 
mobile network with 
Holgram.io's Nova: 
magpi.cc/WXGKxH 
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The Joy-Cons are used to control the games. 
After much struggle, Christopher managed 
to get the analogue sticks working 


PISwitcn 


Retro gaming with a modern twist 


> Christopher Foote > magpi.cc/epZyLp 


hen the Nintendo Switch was first released, 
W it seemed like it would be an inevitability 

for someone to replicate the form factor and 
controller functions to make a Pi-powered retro console. 
Within a few months, Christopher Foote had managed to 
do it. However, it wasn’t quite as easy as 3D-printing a 
few controller connectors. 

Surprisingly, the Linux Joystick Mapper worked with 

the Joy-Cons - the detachable controllers on each side 
of the Switch. However, there was one problem, as 


mı can play one-player with 
both controllers to fully emulate 
a Nintendo 64 or PlayStation @ 


» Joy-Con controllers 
» 7-inch touchscreen 


A big batter 
Christopher recalls: *It worked great apart from the ig g y 


analogue sticks, so I looked through the code for a few 
hours, figured how Linux Joystick Mapper worked, and 
reprogrammed it for Joy-Con compatibility.” 


Custom case 

That was the first step to getting the entire setup rs jn daos n Mies 
working. Next was the case and assembling the hardware, messy 3D print, though 

using a 7-inch touchscreen display, an extended 
headphone jack, built-in speakers, and a custom 

3D- printed case. The real trick to the case is that the 
Joy-Cons can slot into it, much like the real thing. 

“I took my Switch and a pair of digital calipers and I 
measured the inserts for the controllers," Christopher 
says. “I can play one- player with both controllers to 
fully emulate a Nintendo 64 or PlayStation controller... 
The Joy-Cons also load different controller maps.” 


More than games 
It's an amazing feat, and it doesn't just run RetroPie 
either: you can also watch stuff via Kodi, and Christopher 
is trying to figure out Steam streaming as well. 

We think it's great, and apparently so did the folks 
in the community, as you have voted it to be the most 
amazing Raspberry Pi project of the last two-or-so years! 
We wonder what amazing projects we'll see over the 
next two. M 
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The 3D-printed case holds the Pi 3 and other 
components and it includes the locking 
mechanism for the Joy-Con controllers 


The 7-inch Raspberry Pi Touch Display 
is at the heart of the project, which also 
makes use of RetroPie for emulation 


Using digital callipers, Christopher The touchscreen aspects 


was able to replicate the Switch's are also replicated from 
detachable controller function the Switch 
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SUBSCRIBE TODAY 
FROM ONLY £5 


ÙP T6 DO /o 


MODMYPI VOUCHER 


>» FREE Delivery 
Get it fast and for FREE 


» Exclusive Offers 
Great gifts, offers, and discounts 


> Great Savings 
Save up to 35% compared to stores 


» Low Monthly Cost (from £5) 
> Cancel at any time 

l^ Free delivery to your door 
> Available worldwide 


£55 (UK) £90 (USA) 
£80 (EU) £95 (Rest of World) 


Free Pi Zero W Kit with 12 Month upfront subscription 
only (no Pi Zero Kit with Rolling Monthly Subscription) 


© Subscribe online: magpi.cc/subscribe 
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JOIN FOR 12 MONTHS AND GET A 


WITH YOUR SUBSCRIPTION 


Pi Zero W 


Pi Zero W case 
with three covers 


USB and HDMI 
converter cables e 


Camera Module 
connector 


Offer subject to change or 
withdrawal at any time 


SUBSCRIBE 
on app stores 


From £2.29 e 


P> Google Play 
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with the TV HAT 


Set up your new add-on to stream live TV from and to a Raspberry Pi 


Phil 
King 


When not subbing 
The MagPi and 
editing Raspberry 


Pi books, Phil he latest official Raspberry Pi add-on is 

T a must for telly addicts. The Raspberry Pi 

ese d TV HAT enables any Raspberry Pi (with Assemble and mount 

Crown) and other 40-pin GPIO) to decode live digital TV signals and Insert the thin end of the supplied silver RF 

(old Dynasty re- stream them to remote devices - such as another cable adapter into the gold connector on the side 

runs) TV: Pi, computer, or even a smartphone. The HAT’s of the HAT. Take the supplied 40-pin header and 
built-in Sony CXD2880 tuner supports DVB-T2 and insert its pins into the holes in the underside of the 
DVB-T standards (Freeview in the UK), so you can HAT - not into the black female header on the top! 

; watch all your favourite channels. Here we show Mount the HAT on the Pi, with the RF adapter at 

You'll Need you how to set it up, and even use it to turn a Pi the microSD card slot end. To make it secure, you 

into an all-in-one TV/PVR. can screw it in using the supplied stand-offs. 


Raspberry Pi TV HAT 


Wireless network 


Computer 


Recording 


Add a hard drive 
or USB stick to 
your Pi to turn it 
into a capacious Connect your TV aerial 
homemade PVR cable to the HAT via 


m *EE*! 


With the supplied header 


TUTTTTETTITITI 


inserted on its underside, 
with LibreELEC. the supplied adapter ‘ the HAT is mounted on the Pi 
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@ Electronic Program Guide | *, Digital Video Recorder | g” Configuration | # Status  @@ About No verified access (login) Storage space: 8GiB/0/14GiB — 12:18:17 


x.| | Filter content type. vir 


Install Tvheadend 

Connect a coaxial RF cable from a TV aerial 
socket to the RF adapter on the HAT. You'll need 
decent digital terrestrial TV (Freeview in the UK) 
reception for the tuner to work. With Raspbian 
Stretch installed on its microSD card, turn on the 
Raspberry Pi - a green LED will light on the HAT. 

We need to install a back-end TV service to 

stream video: we'll use Tvheadend. To install it, 
open a Terminal window and enter: 


sudo apt-get update 
sudo apt-get install tvheadend 


Configure Tvheadend 

It takes a few minutes for Tvheadend to 
install, so you may want to go and make a cup 
of tea. Once installed, a package configuration 
screen will appear and you'll be prompted to 
enter a Tvheadend administrator user name. 
For simplicity's sake, enter kodi for this, then 
also enter kodi for the password - you can always 
change it later if you prefer. You're now ready 
to log in from another device. 


Log in remotely 

Now that Tvheadend is running, you can 
access it from another computer (possibly a second 
Raspberry Pi). In a web browser, enter this address: 
http://raspberrypi.local:9981/extjs.html. If that 
doesn't resolve, use the Pi's IP address instead, 
followed by :9981/extjs.html. Log in using kodi for 
both the user name and password. A configuration 
wizard will appear, enabling you to choose the TV 
network type and transmitter. 


Configure TV network 

In the configuration wizard's *Network 
settings’, it should show ‘Tuner: Sony CDX2880 tto 
DVB-T #0’. For the Network Type, choose ‘DVB-T 
Network'. For predefined muxes, select your local 
transmitter: for example, ours was uk-Rowridge. 
Upon clicking Save & Next, it'll start scanning for 
muxes and services (channels). After it reaches 
100%, tick all three boxes (Map all services, 
Create provider tags, Create network tags) and an 
electronic programme guide (EPG) will appear. 


Wed, Oct 03, 0... 13 hrs, 28 min 


vM 


An [v [Search tito. Fulltext Filter channel Y. [Fiter tag 
Details Progress Title Subtle Episode Start Time Duration 
&a = | "This Is BBC Four BBC Four is the BBC channel for people w... 

[du] | 29% | "Xpanded TV Č Uve TV Player. 

mds |] E 1307 | "Quest +1 is back at 7pm res 
ca Ie BBC ONE South ~~ OOO # 
GRO) un | iem Suc 

ëa — Mm Wette 

ict "Lauren Laverne 

ëa es "Sasha twining 

€a |_| ‘Adele Roberts 

(CR | | Mia Mornings with Nick Snaith 

TE mo 

&a [Eu | "Live Conservative Party Conference ; 

a Es. | “Aslan Network's Big Debate. 

Gù 77 | "wren ase 

LINE ae | “Ame rove 

wo ae |" 

Ga uen Heil 

(CR — M | "Mike Teolan 

ëa ee "James O'ürlen 

čo 51 

ica "Blaze* back at Jam 


| Stay up to date on the day's top stories, wit... 
(1950) Film noir starring Frank Lovejoy and ... 


E zx 
GC) | cron 
Gc [esp | "The Sound of Fury 


Watching TV 

You can now watch live TV streamed from 
the TV HAT in your browser. In the EPG, click the 
TV icon to the left of any programme to show it in 
a window, which you can expand to full-screen. 
There are also options to schedule and record 
shows - use the Help option for more details. 

As well as using a web browser, you can view 
the TV stream from a variety of clients, including 
Kodi, omxplayer, VLC, and smartphone apps - 
see magpi.cc/ZpJtwd. Ii 


Using LibreELEC 


The live TV stream from the TV HAT can be accessed 
in the Kodi media player, most easily by using 

the LibreELEC OS on a Raspberry Pi. Install the 
Tvheadend client by selecting Add-ons > Install from 
repository > PVR clients > Tvheadend HTSP Client. 

In addition, using LibreELEC, it's possible to set up 
both the Tvheadend client and server on the same 
Raspberry Pi - a Pi 2, 3, or 3B* is recommended - 
for an all-in-one TV/PVR device. To do so, select 
Add-ons » Install from repository » Services » 
Tvheadend Server 4.2, and install it. Access it from 
another computer using the IP address followed by 
:9981 and set it up as in Step 5. You can then access 
it from within LibreELEC (with the Tvheadend client 
installed) by selecting the main 'TV' option. 

To make TV recordings, you'll need to create a 
recordings folder on a connected USB stick or hard 
drive - navigate to it in File Manager, right-click, 
and select 'Make new folder). Then, in the web 
interface on a remote computer, go to Configuration 
» Recordings and set the recording system path to 
var/media/lyour. drive namel/recordings. 


Wed, Oct 03, 1... 2hrs 
Wed, Oct 03,1... 1 hrs, 50 min 


You can access 
the EPG and 
watch live TV ina 
web browser ona 
remote computer 


TopTip è 


Live viewing 


The live TV stream 
can be accessed 
in many ways, 
including Android 
and iOS apps. 
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Evans 


PJ is a writer, 
developer, and 
runs the Milton 
Keynes Jam. He 
is worryingly 
passionate about 
switching things 
on and off. 


mrpjevans.com 


| You'll Need 


» 2x 433MHz 
transceivers 
magpi.cc/yXnbtu 


> 2x Mini 
breadboards 
magpi.cc/QEyLck 


» 12 x M/F 
jumper leads 


magpi.cc/UgGBxg 


» RF mains socket kit 


magpi.cc/vuCjwL 


P Heres everything 
you need. It is 
possible to just use 
one Raspberry Pi, 
but double up for 
more fun 


Build a secret. 
radio chat device 


Add a cheap 433MHz radio to your Raspberry Pi to send wireless 
messages without WiFi and operate remote-control main sockets 


only option for wireless communication 

on the Raspberry Pi? What if there isn't 
a network available or you need a longer range? 
433MHz radio is where you want to be. In this 
tutorial we'll add this capability to a pair of Pi 
boards and show how to send wireless messages 
from one to the other with no WiFi network. Then, 
we'll increase the range with a touch of science and 
start talking to RF-based switchable main sockets. 
Have Pi-controlled sockets all around the house! 


S ure, WiFi is all well and good, but is it the 


Prepare your Pi boards 

To demonstrate sending messages using 
433MHz, it makes sense to use two Raspberry Pi 
boards so we can have a conversation. None of 
what we're doing here requires much processing 
power, so any Pi will do, even original Model As or 
Bs. Depending on what you're comfortable with, 
install either full Raspbian Stretch, or - as we're 
doing here - Raspbian Lite, as everything will 
be run from the command line. If you haven't 


44 | magpicc | Builda secret radio chat device 


got access to multiple monitors and keyboards, 
consider using SSH to access each Pi with two 
windows on your main computer. That way you 
can see everything taking place. 


Meet the transceivers 

Each kit comes with two circuit boards. The 
longer of the two boards is the receiver, sporting 
four pins. Before wiring up, check the labelling 
of these pins very carefully as they do sometimes 
vary. Regardless of position, there will be 5 V power 
in (labelled VCC), ground (GND), and two ‘DATA’ 
lines which transmit the received signals. These 
are identical so you can use either. 

The smaller transmitter has three lines, 

which again can vary in position based on the 
manufacturer. Just like the receiver, you have VCC 
for power, GND for ground, and this time, a single 
data line. 


Wire-up the breadboard 

We're using a tiny breadboard, but any size 
will work. In fact, a larger board with power and 
ground rails might be a bit tidier. Carefully insert 
a receiver and transmitter in each breadboard 
alongside each other. We want the two breadboards 
opposite so that the transmitter of Pi #1 (which we're 
calling ‘Alice’) is pointing directly at the receiver of 
Pi #2 (‘Bob’) and vice versa. 

Connect six jumper leads to each breadboard, 

one on the rail for each pin of the transceiver pair. 
It doesn't matter which ‘DATA’ line you use on 
the receiver. 


Initially, the two Pi boards 
must be really close 

to communicate. We'll 
increase the range later 


Fiad raa 


Connect to the Pi boards 

Connect each Pi to its six jumper leads. 
Luckily, this project doesn't require any additional 
components, so you can wire directly. Both the 
receiver and transmitter run at 5V, so connect 
each VCC jumper lead to physical pins 2 and 4 of 
the GPIO (the top two right-hand pins when pin 1 
is top-left). Next, connect the GND leads to pins 
6 and 9. Although your radio is now powered, it’s 
not much use if it can’t send and receive data, so 
connect the transmitter’s DATA to GPIO17 and the 
receiver’s DATA to GPIO 27 (pins 11 and 13). 


Test receive 

Before we can do anything with our newly 
installed radio, we need some software. Open upa 
Terminal and issue the following commands: 


cd 

sudo apt install python3-pip git 

pip3 install rpi-rf 

git clone https://github.com/mrpjevans/ 
rfchat.git 


You now have everything installed to test your 
hardware. Pick your favourite of the two Raspberry 
Pi boards and enter the following: 


cd ~/rfchat 
python3 receive. py 


Now hold the remote control from the RF kit 
very close to the receiver and press its buttons. See 
numbers appear? Great. If not, review your wiring. 
Press CTRL+C to quit and repeat on the other Pi. 


The 433MHz receiver and 
transceiver come as a pair 
of small PCBs 


Test send 

Position the Raspberry Pi boards so the two 
breadboards are within a centimetre of each other, 
with Alice’s transmitter pointing at Bob’s receiver 
and likewise the other way around. On Alice, start 
the receive script just as we did in the previous 
step. On Bob, enter the following in the Terminal: 


cd ~/rfchat 
python3 send.py 1234 


All being well, ‘1234’ should be displayed 
repeatedly on Alice’s screen. There’s no error 
correction, so it’s normal to see missing or corrupt 
characters. If it doesn’t look quite right, try again. 
Once you’re happy, reverse the test to confirm 
Bob’s receiver is also working. 
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*4 The pair of 
transceivers do not 
require any additional 
components and can 
be wired straight to 
the GPIO 
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P^ The transceiver takes its 
5V power from the Pi, as 
well as the incoming and 
outgoing signals 


07 Let’s have a chat 

Our two Raspberry Pi boards can now 
communicate wirelessly without WiFi. To 
demonstrate what’s possible, take a look at 
the rfchat.py script. This code uses threading 
(code-speak for doing multiple things at once) to 
monitor the keyboard and receiver for data. We 
convert incoming and outgoing data to numbers 
(ASCII) and back. The result is a live chat interface. 
You can now send and receive messages. To start: 


cd ~/rfchat 
python3 rfchat.py 


Now slowly type on either Pi and the message 
will appear on the other. In fact, your local output 
is your receiver picking up your own transmitter! 


Increasing range with science 

The reason for the radio’s poor range is 
the tiny antennas, but this can be fixed. The 
antenna’s length needs to be a harmonic of the 
wavelength, which is calculated by dividing the 
speed of light by the frequency (299 792 458 m/s 
divided by 433000000). You can keep dividing the 
result of 692.36 mm by 2 until you get a sensible 
length. A 173mm antenna is long enough to give 
an impressive range, normally covering a whole 
house. Solder 173 mm wires to all four ‘ANT’ 
solder points on the PCBs. Your rfchat should 
now work over long distances. 


Socket to me 

There are many household devices that 
use 433MHz to send control codes. Among the 
most popular are remote-control mains sockets, 


rfchat.py 


» Language: Python 3 


001. import sys 019. 
002. import tty 020. 
003. import termios 021. 
004. import threading 022. 
005. import time 023. 
006. from rpi rf import RFDevice 024. 
007. 025. 
008. # Elegant shutdown 026. 
009. def exithandler(): 027. 
010. termios.tcsetattr(sys.stdin, termios. 028. 
TCSADRAIN, old settings) 029. 
011. 030. 
012. rx.cleanup() 031. 
013. tx.cleanup() 032. 
014. except: 033. 
015. pass 034. 
016. sys.exit(0) 
017. 035. 
018. # Activate our transmitter and received 036. 


tx - RFDevice(17) 
tx.enable tx() 
rx - RFDevice(27) 


rx.enable rx() 


# Receiving loop 
def rec(rx): 


print(“Receiving”) 


lastTime = None 
while True: 
currentTime = rx.rx_code_timestamp 
if ( 
currentTime != lastTime and 
(lastTime is None or currentTime - 
lastTime > 350000) 
): 


lastTime = rx.rx code timestamp 
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often used to switch lights. These commonly use 
433MHz and protocols that rpi-rf can understand. 


cd ~/rfchat 
python3 receive.py 


Press buttons on the remote control. You’re 
likely to see a list of numbers, repeating for error 
correction, that change with each button. Make a 
note of these and then send them out as follows: 


python3 send.py [number] 


You should hear a reassuring ‘click’ from the 
relay of the socket. Try switching it on or off. 


Make it your own 

These 433MHz units add a range of 
possibilities to your Raspberry Pi projects at a 
very low cost. Not just home automation projects 
with controllable sockets, but also providing radio 
communication where WiFi isn't practical, such as 
high-altitude ballooning or unusually positioned 
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A Aclose look at the 
transceiver. The 
larger board is the 
receiver and the 
smaller square 


radio to deliver and receive any information. board transmits 
Now you can control sockets from your Raspberry 

Pi, you can link these up to any kind of event 

you can imagine. How about detecting your car 

coming home using a Pi Camera Module and 

number-plate recognition, then switching on the 


sensors like flood monitors. IoT devices can use house lights? M 
DOWNLOAD 
THE FULL CODE: 

037. try: 055. 
038. if (rx.rx code -- 13): 056. # Remember how the shell was set up so we can reset 
039. # Enter/Return Pressed on exit 
040. sys.stdout.write(‘\r\n’) 057. old settings = termios.tcgetattr(sys.stdin) 
041. else: 058. tty.setraw(sys.stdin) 
042. sys.stdout.write(chr 059. 

(rx.rx code)) 060. while True: 
043. sys.stdout.flush() 061. 
044. except: 062. # Wait for a keypress 
045. pass 063. char = sys.stdin.read(1) 
047. 064. 
048. time.sleep(0.01) 065. it If CTRL-C, shutdown 
049. 066. if ord(char) == 3: 
050. # Start receiving thread 067. exithandler() 
051. t - threading.Thread(target-rec, 068. else: 

args-(rx,), daemon-True) 069. it Transmit character 
052. t.start() 070. tx.tx code(ord(char)) 
053. 071. 
054. print(*Ready to transmit") 072. time.sleep(0.01) 
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Veteran magazine 
author from the old 
days, writer of the 
Body Build series, 
plus co-author of 
Raspberry Pi for 
Dummies, Raspberry 
Pi Projects, and 
Raspberry Pi Projects 
for Dummies. 
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P1 Bakery: 
The Matrix 


The Matrix is an undedicated array of switches and lights 
that can be put to any number of uses - this month, 


let's do the final assembly 


the controller board. Now we see how to bring 
all the parts we have built so far together and 
see the basic functions come to life. 


| ast month we completed the construction of 


Wiring up the LED boards 

We need to take the LED boards and 
add some wires so we can connect them to the 
controller board (Figure 1). While electricity 
doesn’t care what colour wires it flows through, 
it helps us enormously to connect them up to the 


Just the LED board 


a u^ 


Complete mounted switch 
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right place. We used violet, blue, green, red, and 
orange wire for this (as shown in Figure 12 in the 
first part of this tutorial, issue 73). That is orange 
for the cathode, red for the red LED Ao, green for 
the green LED A1, blue for the blue LED A3, and 
finally violet for the switch pin SW. 


Getting the wires the right length 

We soldered one end of the wires to 
each wire reel and gathered the wires together 
(Figure 2). Then we pulled out a sufficient quantity 
of wire to reach the controller board from one of 
the matrix positions and snipped off all the wires. 
Remember that wires need to reach both sides 
of the controller board, so it's better to make the 
wires too long rather than too short. Next, we took 
a battery tray and put a temporary sticky label on it 
with the matrix position number written on it, and 
finally passed the wires through the side slot. We 
repeated this for all matrix positions. 


A Figure 2 Attaching all five 
wires to the LED board 
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| You'll Need 


> 2x 40-way IDC 
connectors 
magpi.cc/MLBnKF 


» 600 mm of 40-way 
ribbon cable 
magpi.cc/ysjGdR 


» Red, green, 
blue, orange, 
and violet wire 
magpi.cc/QNcPdi 


YV Figure 3 The 
schematic of the 
matrix made from 
LED boards 


C4 C6 


< Figure 1 Setting up 
your workspace 


Module 3 


Module 1 Module 2 
Seg a 
Seg b 
Seg c 


Seg a 
Seg b 
Seg c 


Seg e 
Seg f 
segg 


Sege 
Seg f 
segg 


Seg a 
Seg b 
Seg c 


Seg a 
Seg b 
Seg c 


Seg e 
Seg f 
Seg g 


Seg e 
Seg f 
Seg g 


Figure 3 
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Figure 4 Wiring the 
first LED position to 
the control board 
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Figure 5 The orange cathode wires 
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Figure 6 The red segment a & e wires 
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Segment a 


Segment e 


Segment a 


Segment e 


The matrix circuit 

The LED boards are wired up to the 
controller to form the matrix, this is shown in 
Figure 3. Each numbered module is an LED board 
(whose schematic was shown in Figure 11 in 
the first part of this tutorial, issue 73), and the 
connections out of this diagram - Co to C7, SWo 
to SW15, and Seg a to Seg g, - go to the controller 
board schematic (Figure 6 in part two of this 
tutorial, issue 74). These three schematics form 
what is known as a hierarchical schematic, where 
a complex section of circuit is drawn as a block and 
that block has a schematic showing its circuitry. 
In this case there are three levels of hierarchy. 


Starting the wiring 

Place the controller board on the back of the 
tray next to the slot in the side at matrix position 11, 
and draw a line round it for reference. Then take the 
LED tray for position 10 and feed the wires through 
the hole in the board and clip the battery tray to the 
base on the front. Next, connect the five wires up to 
the controller board, as shown in Figure 4. We then 
added all the other LED modules and pulled the 
wires through the holes, without wiring them up so 
we weren't forever turning the box over. 


Complete the wiring 

Stand the lid of the box on four blocks so 
the LEDs are not being crushed by the bench. 
Then concentrate on one colour wire at a time; 
i.e. wire up all the red wires from each LED to the 
control board, then the blue and so on. They all 
go to one of two places on the control board, with 
the exception of the violet switch wires: these go 
to different GPIO pins on the ribbon cable header. 
Figures 5 to 9 show the wiring for each individual 
LED wire. Note that the control board has been 
separated for clarity. 


Top Tip 
Attaching wires to the LED boards 


We used a reel of solder as a weight to anchor the 
wires to the bench, and some snipe-nose pliers to 
prevent the LED boards from flipping over while 
soldering the wires. 


Top Tip 
Remember the special one 


Matrix position 11 has the wire entry hole in a different 
place to the others, so that it does not come up 
underneath the control board. 


Attaching the matrix to the Pi 

To attach the Matrix to the Pi, we use 
two 40-way IDCs (insulation displacement 
connectors) and an approximately 600 mm 
length of 40-way ribbon cable. Line up the 
cable in the connector, with the arrow on 
the left-hand side pointing towards the red 
conductor. Then tighten the vice up slowly until 
the connectors pierce the cable completely 
(Figure 10, overleaf). Crimp up the other end 
of the cable, and make sure the connectors are 
placed as seen in Figure 11 (overleaf). Finally, 
loop the cable over itself at the Pi end and fita 
strain-relief clip if you have one. 


Testing the circuit 

Let's test the hardware. Type in and run the 
code in Matrix test.py. This will, at first, turn on 
the red LED of each switch. Pressing that switch 
will turn the LED green; press again for a blue. The 
final press will turn all the LEDs on that switch off. 
A printout is given when any switch is changed. 
If this does not happen then check the control 
board for short circuits and the wiring for correct 
routing. Note, at this stage sometimes the LEDs 
will randomly toggle while the Pi is busy - we will 
fix that later in the final code. 


Fixing the LED boards 

The LED boards need to be fastened down, 
to prevent the wires pushing them up and stopping 
the switches from operating correctly. We found 
the best way was to use a small amount of hot- 
melt glue. Remove the labels in the battery tray, 
align the LED boards with the reflector, then apply 
a small round dab of hot-melt glue to the bottom 
of the LED board, and quickly push it into place, 
using the reflector to ensure it is lined up with the 
reflector pegs on the battery case. 
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Figure 8 The blue segment c & 
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Figure 9 The violet switch wires 
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= Figure 10 Crimping 
the ribbon cable to 
the connector 
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Final assembly 

We found that when the cover, lens, and 
reflector were placed over the LED, there was not 
enough travel to make the switch turn on and off 
reliably due to the wires on the underside of the 
LED board. So we increased the travel on the switch 
by removing the small raised part on the back 
of the reflector with a flat-ended router bit. You 
can use either a pillar drill with the router in the 
chuck, a hand-held drill or Dremel, or you can use 
a scalpel. Figure 12 shows the three stages of this 
process: before, during, and after. 


With the hardware tested and working, next month 
we will see how to adapt our test code, and make 

it into a fully-fledged Python library. Then we will 
start to use that library to put our Matrix to work. El 


Matrix test.py 


001. import time 

002. import RPi.GPIO as io 

003. 

004. dataPin 14 ; clockPin = 15 ; 
loadPin = 18 ; buttons = @ ; 
oldButtons = ð 

005. buttonPins = [12,25,24,23,6,13,19,26, 
16,20,21,4,17,27,22,5] # rows 

006. ledsState = [ 0,0,0,0,0, 
0,0,0,0,0,0,0,0,0,0,0] 

#0=off,1=red, 2=green, 3=blue 

007. ledCol - [0,64,32,16,0,4,2,1] 
# LED colour number 

008. register = [0,0,0,0,0,0,0,0,0] 

# copy of the Max chip's registers 

009. address = [13,355,75 15355,7; 
2,4,6,8, 2,4,6,8] # switch number to 
register address 


010. colOff - [0,0,0,0, 4,4,4,4, 
0,0,0,0, 4,4,4,4] # colour offset per 
switch 

011. 

012. def main(): 

013. global register 

014. print("Matrix test") 

015. init_io() 

016. init max7219() 

017. time.sleep(0.04) 

018. clrLED() 

019. readButtons() 

020. for switch in range(0,16): 

021. setLed(switch,ledsState[switch]) 

022. while True: 

023. for switch in range (0,16): 

024. readButtons() 

025. if buttonsChanged : 

026. print("Bit pattern", 
fullBin(buttons), 

" Number -",buttons,) 

027. for switch in range(0,16): 

028. if buttons & (1 << 
switch) != oldButtons & 

(1 << switch) : 

029. print( 

"changing switch number", switch) 
03e. setLed(switch, 
ledsState[switch]) 
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DOWNLOAD 
THE FULL CODE: 


© magpi.cc/1NqJjmV 


031. 


time.sleep(0.2) 


032. 


033 


034. 
035. 
036. 
037. 
038. 
039. 
040. 
041. 
042. 
043. 


044. 


. def setLed(switch,col): # increment LED state & 
display 
global register 
reg = address[switch] 
ledsState[switch] += 1 
if ledsState[switch] >3 : 
ledsState[switch] = @ 
if colOff[switch] == 0 : 
register[reg] &- @x@F # clear bottom bits 
else: 
register[reg] &- OxFO # clear top bits 
register[reg] |- 
ledCol[colOff[switch]+ledsState[switch] ] 
sendMax(address[switch],register[reg]) 


045. 


046. 
047. 
048. 
049. 
050. 
051. 
052. 
053. 


def fullBin(num): # to show all leading zeros 


binary = "" 
for i in range(15,-1,-1): 
if num & (1 << i): 
binary = binary «' i" 
else: 
binary = binary +"0" 
return binary 


054. 


055. 
056. 
057. 
058. 
059. 


060. 
061. 
062. 
063. 
064. 
065. 


def init io(): 
io.setmode(io.BCM) 
io.setwarnings(False) 
for i in range (0, len(buttonPins)): 
io.setup(buttonPins[i], io.IN, 
pull up down-io.PUD UP) 
io.setup(dataPin, io.OUT) # data out 
output(dataPin, 0) 
.setup(clockPin, io.OUT) # clock 
io.output(clockPin, 0) 
.setup(loadPin, io.OUT) # not load 
output(loadPin, 1) 


io. 
io. 
io 


io 
io. 


066. 


067. 
068. 
069. 
070. 
071. 
072. 
073. 


def readButtons(): 
global buttons, buttonsChanged, oldButtons 
buttonsChanged - False 
oldButtons - buttons 
newBut - 0 
for i in range (0, len(buttonPins)): 
edge - io.wait for edge(buttonPins[i], 
io.FALLING, 1,2) 


074. if edge -- None: 

075. newBut &- OxFFFF ^ (1<< i) # clear bit in 
variable 

076. else: 

077. newBut |= 1<< i # set bit in variable 

078. if newBut !- buttons : # we have a changed from 
last time 

079. buttons - newBut 

080. buttonsChanged - True 

081. 

082. def clrLED(): 

083. for add in range(1,9): # all display registers 

084. sendMax(add,0) 

085. 

086. def init max7219(): 

087. sendMax(0x9,0) # no decode 

088. sendMax(0xB, 7) it scan all digits 

089. sendMax(0xA,0x15) # maximum intensity 

090. sendMax(0xC, 1) it take out of shutdown mode 

091. 

092. def sendMax(add,data): # send a byte to mux chip 

093. package = add << 8 | data # join into one bit 
pattern 

094. io.output(loadPin, 0) # lower load 

095. for i in range(15,-1,-1): # from 15 to @ 

096. io.output(dataPin, 1 & (package >> i)) # send 
MSB first 

097. io.output(clockPin, 1) # toggel clock 

098. io.output(clockPin, 9) 

099. io.output(loadPin, 1) # latch value 

100. 

101. 4 Main program logic: 

102.if name == ' main ': 

103. main() 


Start with issue 73 


This is the latest instalment in a series of Mike's Pi 
Bakery tutorials. You can download digital editions 
of previous tutorials for free. Start with The MagPi #73. 


magpi.cc/73 
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Raspberry Pi! 
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@mindexplorers 


| You'll Need 


> An image 
manipulation 
program such 
as GIMP, or 
images from 
magpi.cc/mYSswY 


The latest version 
of Pygame 
Zero (1.2) 


v 


v 


The Audacity 
sound editor or 
similar or sounds 
available from 
magpi.cc/mYSswY 


v 


Speakers or 
headphones 


Pygame Zero 
Invaders II 


Space Invaders must be the first computer game that springs to mind 
for a lot of people. Here in part two we will take our basic game from 


part one and add all the extras 


our Space Invaders game with our player ship 

controlled by the keyboard, defence bases, the 
aliens moving backwards and forwards across the 
screen, and lasers flying everywhere. In this part 
we will add lives and levels to the game, introduce 
a bonus alien, code a leader board for high scores, 
and add some groovy sound effects. We may even 
get round to adding an introduction screen if we 
get time. We are going to start from where we left 
off in part one. If you don't have the part one code 
and files, you can download them from GitHub 
at magpi.cc/JxQrdd. 


[ n part one, last issue, we set up the basics for 


You only live thrice 

It was a tradition with Space Invaders to be 
given three lives at the start of the game. We can 
easily set up a place to keep track of our player 
lives by writing player.lives = 3 in our init() 
function. While we are in the init() function, let’s 
add a player name variable with player.name = "" 
so that we can show names on our leader board, but 
we'll come to that in a bit. To display the number of 
lives our player has, we can add drawLives() to our 
draw() function and then define our drawLives() 
function containing a loop which ‘blits’ life.png 
once for each life in the top left of the screen. 


Introduction screen 
with input field for 
player's name 


PYG@AME ZERO INVADERS 


Type your name then 


(arrow keys move, space to fire) 


If the player shoots all the aliens, 
they move on to the next level 
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The player has three lives 
at the start of the game 


A bonus or ‘boss’ alien 
appears from time to time 


Scores from previous 
games are listed on the 
leader-board screen 


Life after death 

Now we have a counter for how many lives 
the player has, we will need to write some code to 
deal with what happens when a life is lost. In part 
one we ended the game when the player.status 
reached 30. In our update() function we already 
have a condition to check the player.status and 
if there are any aliens still alive. Where we have 
written if player.status == 30: we can write 
player.lives --1. We can also check to see if the 
player has run out of lives when we check to see if 
the RETURN (aka ENTER) key is pressed. 


Keep calm and carry on 

Once we have reduced player.lives by 
one and the player has pressed the RETURN key, 
all we need to do to set things back in motion is to 
set player.status - 0. We may want to reset the 
laser list too, because if the player was hit by a flurry 
of lasers we may find that several lives are lost 
without giving the player a chance to get out of the 
way of subsequent lasers. We can do this by writing 
lasers = []. If the player has run out of lives at 
this point, we will send them off to the leader-board 
page. See figure1.py to examine the code for dealing 
with lives. 
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figure1.py 


On the level 

The idea of having levels is to start the game 
in an easy mode; then, when the player has shot all 
the aliens, we make a new level which is a bit harder 
than the last. In this case we are going to tweak a 
few variables to make each level more difficult. To 
start, we can set up a global variable level - 1in 
our init() function. Now we can use our level 
variable to alter things as we increase the value. 
Let's start by speeding up how quickly the aliens 
move down the screen as the level goes up. When 
we calculate the movey value in updateAliens(), 
we can write movey = 40 + (5*level)onthe 
condition that moveSequence is 10 or 30. 


001. def draw() 


002. # additional drawing code 
003. drawLives() 
004. if player.status »- 30: 
005. if player.lives > 9: 
006. drawCentreText( 
"YOU WERE HIT!\nPress Enter to re-spawn") 
007. else: 
008. drawCentreText( 
"GAME OVER!\nPress Enter to continue") 
009. 
010. def init(): 
011. # additional player variables 
012. player.lives - 3 
013. player.name = "" 
014. 
015. def drawLives(): 
016. for l in range(player.lives): 
017. screen.blit("life", (10+(1*32),10)) 
018. 
019. def update(): 
020. it additional code for life handling 
021. global player, lasers 
022. if player.status < 30 and len(aliens) > ð: 
023. if player.status > 0: 
024. player.status += 1 
025. if player.status -- 30: 
026. player.lives -= 1 
027. else: 
028. if keyboard.RETURN: 
029. if player.lives > ð: 
030. player.status = ð 
031. lasers = [] 
032. else: 
033. # go to the leader-board 
034. pass; 
035. 


036. def drawCentreText(t): 


037. screen.draw.text(t , center-(400, 300), owidth-0.5, 
ocolor=(255,255,255), color=(255,64,0) , fontsize-60) 


On the up 

To go from one level to the next, the player 
will need to shoot all the aliens. We can tell if 
there are any aliens left if len(aliens) = 0. So, 
with that in mind, we can put a condition in our 
draw() function with if len(aliens) -- 0: and 


then draw text on the screen to say that the level 
has been cleared. We can put the same condition 
in the section of the update( ) function where 

we are waiting for RETURN to be pressed. When 
RETURN is pressed and the length of the aliens list 
is O, we can add 1 to level and call initAliens() 
and initBases() to set things ready to start the 
new level. 


A Code to deal 
with player 
lives. Notice the 
drawCentreText() 
function to short-cut 
printing text to the 
centre of the screen 
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py 


001. def updateBoss(): 

002. global boss, level, player, lasers 
003. if boss.active: 

004. boss.y += (0.3*level) 


005. 
006. 
007. 
008. 
009. 
010. 
011. 
012. 
013. 
014. 
(boss.x, 
015. 
016. 


if boss.direction == 0: boss.x -= (1* level) 

else: boss.x += (1* level) 

if boss.x < 100: boss.direction 

if boss.x > 700: boss.direction = 

if boss.y > 500: 
sounds.explosion.play() 
player.status = 1 
boss.active = False 

if randint(0, 30) == @: 
lasers.append(Actor("laser1", 

boss.y))) 
lasers[len(lasers)-1].status = ð 
lasers[len(lasers)-1].type = 0 


Il 
or 


017. else: 


018. 
019. 
020. 
021. 
022. 


if randint(0, 800) == 80: 
boss.active - True 
boss.x - 800 
boss.y - 100 
boss.direction = 0 


A Code to update the 


boss or bonus alien 
This code runs when 
the boss is active 

or uses random 
numbers to see if it's 
time to make it active 


Front and centre 

You may have noticed in figure1.py 
that we made a couple of calls to a function 
called drawCentreText() which we have not 
yet discussed. All that this function does is to 
shorten the process of writing text to the centre 
of the screen. We assume that the text will be 
positioned at coordinates (400, 300) and will 
have a set of standard style settings and colours, 
and the function definition just contains one 
ine: screen.draw.text(t , center-(400, 
300), owidth=@.5, ocolor=(255,255,255), 
color=(255,64,0), fontsize-60) - where t is 
passed into the function as a parameter. 


07 Flying like a boss 
To liven up our game a little bit, we are 

going to add in a bonus or boss alien. This could 
be triggered in various ways, but in this case we 
will start the boss activity with a random number. 
First we will need to create the boss actor. Because 
there will only ever be one boss alien on screen at 
any time, we can just use one actor created near 
the start of our code. In this case we don’t need to 
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c "WNOOUWERETBIT 


== Press Enter to respawn 


A Lasers can be very bad for your health. Best to avoid them 


give it coordinates as we will start the game with 
the boss actor not being drawn. We write boss = 
Actor("boss"). 


Keeping the boss in the loop 

We want to start the game with the boss 
not being displayed, so we can add to our init() 
function boss.active = False and then in our 
draw() function if boss.active: boss.draw(), 
which will mean the boss will not be drawn until 
we make it active. In our update() function, along 
with our other functions to update elements, 
we can call updateBoss( ). This function will 
update the coordinates of the boss actor if it is 
active or, if it is not, check to see if we need to 
start a new boss flying. See figure2.py for the 
updateBoss() function. 


Did you hear that? 

You may have noticed that in figure2.py 
we have an element of Pygame Zero that we have 
not discussed yet, and that is sound. If we write 
sounds .explosion.play(), then the sound file 
located at sounds/explosion.wav will be played. 
There are many free sound effects for games on the 
internet. If you use a downloaded WAV file, make 
sure that it is fairly small. You can edit WAV sound 
files with programs like Audacity. We can add 
sound code to other events in the program in the 
same way, like when a laser is fired. 


More about the boss 

Staying with figure2.py, note how we can 
use random numbers to decide when the boss 
becomes active and also when the boss fires 
a laser. You can change the parameters of the 
randint() function to alter the occurrence of these 


events. You can also see that we have a simple path 
calculating system for the boss to make it move 
diagonally down the screen. We use the level 
variable to alter aspects of the movement. We treat 
the boss lasers in the same way as the normal alien 
lasers, but we need to have a check to see if the 
boss is hit by a player laser. We do this by adding a 
check to our checkPlayerLaserHit() function. 


Three strikes and you're out 

In the previous episode, the game ended if 
you were hit by a laser. In this version we have three 
chances before the game ends, and when it does, we 
want to display a high score table or leader board to 
be updated from one player to the next. There are a 
few considerations to think about here. We need a 
separate screen for our leader board; we need to get 
players to enter their name to put against each score 
and we will have to save the score information. 
In other programs in this series we have used the 
variable gameStatus to control different screens, 
so let's bring that back for this program. 
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figure3.py 


001. def on key down(key): 


002. global player 

003. if gameStatus == @ and key.name != "RETURN": 
004. if len(key.name) -- 1: 

005. player.name += key.name 

006. else: 

007. if key.name -- "BACKSPACE": 

008. player.name = player.name[:-1] 


Screen switching with 

gameStatus 
We will need three states for the gameStatus 
variable. If it is set to o then we should display an 
intro screen where we can get the player to type 
in their name. If it is set to 1 then we want to run 
code for playing the game. And if it is set to 2 then 
we display the leader-board page. Let’s first deal 
with the intro screen. Having set our variable to o 
at the top of the code, we need to add a condition to 
our draw() function: if gameStatus -- 0:.Then, 
under that, use drawCentreText() to show some 
intro text and display the player.name string. To 
start with, player.name will be blank. 


A name is just a name 

Now to respond to the player typing their 
name into the intro screen. We will write a very 
simple input routine and put it in the built-in 
Pygame Zero function on key. down(). figure3.py 
shows how we do this. With this code, if the 
player presses a key, the name of the key is added 
to the player.name string unless the key is the 
BACKSPACE key, in which case we remove the last 
character. Notice the rather cunning way of doing 


that with player.name - player.name[:-1]. We 
also ignore the RETURN key, as we can deal with 
that in our update() function. 


Game on 

When the player has entered their name 
on the intro screen, all we need to do is detect a 
press of the RETURN key in our update( ) function 
and we can switch to the game part. We can easily 
do this by just writing if gameStatus -- 8: 
and then under that, if keyboard.RETURN and 
player.name !- "": gameStatus - 1. We will 
also now need to put our main game update code 
under a condition, if gameStatus -- 1:. We will 
also need to have the same condition in the draw() 
function. Once this is done, we have a system for 
switching from intro screen to game screen. 


Leader of the pack 

So now we come to our leader-board screen. 
It will be triggered when the player loses the third 
life. When that happens, we set gameStatus to 2 
and put a condition in our draw() and update() 
functions to react to that. When we switch to our 
leader board, we need to display the high score 
list — so, we can write in our draw() function: 
if gameStatus -- 2: drawHighScore(). Going 
back to figure1.py, you'll see that we left a section 
at the end commented out, ready for the leader 
board. We can now fill this in with some code. 


If only | learned to read and write 
We are going to save all our scores in a 
file so that we can get them back each time the 


A Code for capturing 
keyboard input for 
the player to input 
their name on the 
introduction screen 


Start with 
issue 71 


This is the latest 
instalment 

in a series of 
Pygame Zero 
tutorials. You 
can download 
digital editions 
of previous 
tutorials for free. 
Start with The 
MagPi #71. 


magpi.cc/71 


SPBERRY PI 


ei 
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figure4.py 


001. 
002. 
003. 
004. 
005. 
006. 
007. 
008. 
009. 
010. 
011. 
012. 
013. 
014. 


015. 
016. 
017. 
018. 
019. 
020. 
021. 
022. 
023. 
024. 
025. 


026. 
027. 
028. 


029. 
030. 


def readHighScore(): 
global highScore, score, player 
highScore = [] 


Try: 
hsFile = open("highscores.txt", "r") 
for line in hsFile: 
highScore.append(line.rstrip()) 
except: 


pass 
highScore.append(str(score)+ + player.name) 
highScore.sort(key=natural_key, reverse=True) 


def natural_key(string_): 
return [int(s) if s.isdigit() else s for s in 
re.split(r'(\d+)', string )] 


def writeHighScore(): 
global highScore 
hsFile - open("highscores.txt", "w") 
for line in highScore: 
hsFile.write(line + "\n") 


def drawHighScore(): 

global highScore 

y=0 

screen.draw.text("TOP SCORES", midtop-(400, 30), 
owidthz0.5, ocolor=(255,255,255), color=(@,64,255) , 
fontsize=60) 

for line in highScore: 

if y « 400: 


screen.draw.text(line, midtop-(400, 100+y), 


owidth=@.5, ocolor-(0,0,255), color=(255,255,0) , 
fontsize-50) 
y += 50 
screen.draw.text("Press Escape to play again" , 
center-(400, 550), owidth=@.5, ocolor=(255,255,255), 
color=(255,64,0) , fontsize-60) 


A Code for reading, 
writing, sorting, and 
drawing the high 
score leader board 


game is played. We can use a simple text file for 
this. When a new score is available, we will have 
to read the old score list in, add our new score to 


the list, sort the scores into the correct order, and 
then save the scores back out to create an updated 
file. So, the code we need to write in our update() 


function will be to call a readHighScore() 
function, set our gameStatus to 2, and call a 
writeHighScore() function. 
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LEVEL CLEARED! 


Press Enter to go to the next level 


A Allthe aliens have been destroyed. It's time to move up a level 


17 Functions need to function 
We have named three functions that 

need writing in the last couple of steps: 
drawHighScore(), readHighScore(), and 
writeHighScore().Have a look at figure4.py to see 
the code that we need in these functions. The file 
reading and writing are standard Python functions. 
When reading, we create a list of entries and 
add each line to a list. We then sort the list into 
highest-score-first order. When we write the file, 
we just write each list item to the file. To draw the 
leader board, we just run through the high-score 
list that we have sorted and draw the lines of text 
to the screen. 


Sort it out 

It's worth mentioning the way we are 
sorting the high scores. In figure4.py we are 
adding a key sorting method to the list sorting 
function. We do this because the list is a string 
but we want to sort by the high score, which is 
numerical, so we break up the string and convert 
it to an integer and sort based on that value rather 
than the string. If we didn't do this and sorted as 
a string then all the scores starting with 9 would 
come first, then all the 8s, then all the 7s and so 
on, with 9000 being shown before 80000, which 
would be wrong. 


Well, that's all folks 

That's about all we need for our Pygame 
Zero Invaders game other than all the additions 
that you could make to it. For example, you could 
have different graphics for each row of aliens. 
We're sure you can improve on the sounds that 
we have supplied, and there are many ways that 
the level variable can be worked into the code 
to make the different levels more difficult or 
more varied. M] 
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invaderspart2.py 


DOWNLOAD 
THE FULL CODE: 


eo magpi.cc/gRWABf 


001. 
002. 
003. 
004. 
005. 
006. 
007. 
008. 
009. 
010. 
011. 


012. 


013. 
014. 


015. 
016. 
017. 
018. 
019. 
020. 


021. 


022. 
023. 
024. 
025. 


026. 
027. 


028. 
029. 


030. 


031. 
032. 
033. 
034. 


035. 
036. 
037. 


import pgzrun, math, re, time 

from random import randint 

player = Actor("player", (400, 550)) 
boss = Actor("boss") 

gameStatus = 0 

highScore = [] 


def draw(): # Pygame Zero draw function 
screen.blit('background', (0, 0)) 
if gameStatus == 0: # display the title page 
drawCentreText("PYGAME ZERO INVADERS\n\n\ 
nType your name then\npress Enter to start\n(arrow 
keys move, space to fire)") 
screen.draw.text(player.name , 
center-(400, 500), owidth=0.5, ocolor-(255,0,0), 
color-(0,64,255) , fontsize-60) 
if gameStatus == 1: # playing the game 
player.image = 
player.images[math.floor(player.status/6)] 
player.draw() 
if boss.active: boss.draw() 
drawLasers() 
drawAliens() 
drawBases() 
screen.draw.text(str(score) , 
topright=(780, 10), owidth=0.5, 
ocolor=(255,255,255), color=(0,64,255) , 
fontsize=60) 
screen.draw.text(" LEVEL " + 
str(level) , midtop-(400, 10), owidth=0.5, 
ocolor=(255,255,255), color-(0,64,255) , 
fontsize-60) 
drawLives() 
if player.status »- 30: 
if player.lives » 9: 
drawCentreText( 
"YOU WERE HIT!\nPress Enter to re-spawn") 
else: 
drawCentreText( 
"GAME OVER! \nPress Enter to continue") 
if len(aliens) == 0 : 
drawCentreText("LEVEL CLEARED! \nPress 
Enter to go to the next level") 
if gameStatus == 2: # game over show the 
leaderboard 
drawHighScore() 


def drawCentreText(t): 

screen.draw.text(t , center-(400, 300), 
owidth=@.5, ocolor=(255,255,255), color-(255,64,0) 
, fontsize-60) 


def update(): # Pygame Zero update function 
global moveCounter, player, gameStatus, 
lasers, level, boss 


038. 
039. 
040. 
041. 
042. 
043. 
044. 
045. 
046. 
047. 
048. 
049. 
050. 
051. 
052. 
053. 
054. 
055. 
056. 
057. 
058. 
059. 
060. 
061. 
062. 
063. 
064. 
065. 
066. 
067. 
068. 
069. 
070. 
071. 
072. 
073. 
074. 
075. 
076. 
077. 
078. 
079. 
080. 
081. 
082. 
083. 
084. 
085. 
086. 
087. 
088. 
089. 
090. 
091. 


if gameStatus -- 0: 
if keyboard.RETURN and player.name !- 
gameStatus - 1 
if gameStatus -- 1: 
if player.status < 30 and len(aliens) > 0: 
checkKeys() 
updateLasers() 
updateBoss() 
if moveCounter = 
moveCounter += 1 
if moveCounter == moveDelay: 
moveCounter = @ 
if player.status > @: 
player.status += 1 
if player.status == 30: 
player.lives -= 1 


= @: updateAliens() 


else: 
if keyboard.RETURN: 
if player.lives > ð: 
player.status = @ 
lasers = [] 
if len(aliens) == @: 
level += 1 
boss.active = False 
initAliens() 
initBases() 
else: 
readHighScore() 
gameStatus - 2 
writeHighScore() 
if gameStatus -- 2: 
if keyboard.ESCAPE: 
init() 
gameStatus - 0 


def on key down(key): 
global player 
if gameStatus == 0 and key.name != "RETURN": 
if len(key.name) -- 1: 
player.name += key.name 
else: 
if key.name -- "BACKSPACE": 
player.name - player.name[:-1] 


def readHighScore(): 
global highScore, score, player 
highScore - [] 
try; 
hsFile = open("highscores.txt", "r") 
for line in hsFile: 
highScore.append(line.rstrip()) 
except: 
pass 
highScore.append(str(score)+ 
player .name) 


+ 
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092. 
093. 
094. 
095. 


096. 
097. 
098. 
099. 
100. 
101. 
102. 
103. 
104. 
105. 
106. 


107. 
108. 
109. 
110. 


111. 
112. 


113. 
114. 
115. 
116. 
117. 
118. 
119. 
120. 
121. 
122. 
123. 
124. 
125. 
126. 
127. 
128. 
129. 
130. 
131. 
132. 
133. 
134. 
135. 
136. 
137. 
138. 
139. 


140. 
141. 
142. 


highScore.sort(key-natural key, reverse-True) 


def natural key(string ): 
return [int(s) if s.isdigit() else s for s in 
re.split(r'(\d+)', string )] 


def writeHighScore(): 
global highScore 
hsFile = open("highscores.txt", "w") 
for line in highScore: 
hsFile.write(line + "An") 


def drawHighScore(): 
global highScore 
y=0 
screen.draw.text("TOP SCORES", midtop= 
(400, 30), owidth=0.5, ocolor=(255,255,255), 
color-(0,64,255) , fontsize=60) 
for line in highScore: 
if y « 400: 
screen.draw.text(line, midtop- 
(400, 100*y), owidth-0.5, ocolor-(0,0,255), 
color=(255,255,0) , fontsize-50) 
y += 50 
screen.draw.text( 
"Press Escape to play again" , center= 
(400, 550), owidth-0.5, ocolor=(255,255,255), 
color=(255,64,0) , fontsize=60) 


def drawLives(): 
for 1 in range(player.lives): 
screen.blit("life", (10+(1*32),10)) 


def drawAliens(): 
for a in range(len(aliens)): aliens[a].draw() 


def drawBases(): 
for b in range(len(bases)): 
bases[b].drawClipped() 


def drawLasers(): 
for 1 in range(len(lasers)): lasers[1].draw() 


def checkKeys(): 
global player, score 
if keyboard.left: 
if player.x > 40: player.x -- 5 
if keyboard.right: 
if player.x « 760: player.x += 5 
if keyboard. space: 
if player.laserActive == 1: 
sounds.gun.play() 
player.laserActive = 0 
clock.schedule(makeLaserActive, 1.0) 
lasers.append(Actor("laser2", 
(player.x,player.y-32))) 
lasers[len(lasers)-1].status = 
lasers[len(lasers)-1].type = 1 
score -= 100 


0 


def makeLaserActive(): 
global player 
player.laserActive - 1 


def checkBases(): 
for b in range(len(bases)): 
if 1 < len(bases): 
if bases[b].height « 5: 
del bases[b] 


def updateLasers(): 
global lasers, aliens 
for 1 in range(len(lasers)): 
if lasers[1].type == ð: 
lasers[l].y += 2 
checkLaserHit (1) 
if lasers[1].y > 600: 
lasers[1].status = 1 
if lasers[1].type == 1: 
lasers[l].y -= 5 
checkPlayerLaserHit(1) 
if lasers[l].y < 10: 
lasers[1].status = 1 
lasers = listCleanup(lasers) 
aliens = listCleanup(aliens) 


def listCleanup(1): 
newList = [] 
for i in range(len(1)): 
if l[i].status == 0: 
newList.append(l[i]) 
return newList 


def checkLaserHit(1): 
global player 
if player.collidepoint((lasers[1].x, 
lasers[1].y)): 
sounds.explosion.play() 
player.status - 1 
lasers[1].status = 1 
for b in range(len(bases)): 
if bases[b].collideLaser(lasers[1]): 
bases[b].height -= 10 
lasers[1].status = 1 


def checkPlayerLaserHit(1): 
global score, boss 
for b in range(len(bases)): 
if bases[b].collideLaser(lasers[1]): 
lasers[1].status = 1 
for a in range(len(aliens)): 
if aliens[a].collidepoint((lasers[1].x, 
lasers[1].y)): 
lasers[1].status = 1 
aliens[a].status - 1 
score += 1000 
if boss.active: 
if boss.collidepoint((lasers[1].x, 
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200. lasers[1].y)): 254. boss.y - 100 
201. lasers[1].status - 1 255. boss.direction = @ 
202. boss.active = 0 256. 
203. score += 5000 257. def init(): 
204. 258. global lasers, score, player, moveSequence, 
205. def updateAliens(): moveCounter, moveDelay, level, boss 
206. global moveSequence, lasers, moveDelay 259. initAliens() 
207. movex = movey = @ 260. initBases() 
208. if moveSequence < 10 or moveSequence > 30: 261. moveCounter = moveSequence = player.status = 
209. movex = -15 score = player.laserCountdown = @ 
210. if moveSequence == 10 or moveSequence == 30: 262. lasers = [] 
211. movey = 40 + (5*level) 263. moveDelay = 30 
212. moveDelay -= 1 264. boss.active = False 
213. if moveSequence »10 and moveSequence < 30: 265. player.images = 
214. movex = 15 ["player","explosion1", "explosion2","explosion3", 
215. for a in range(len(aliens)): "explosion4","explosion5"] 
216. animate(aliens[a], pos-(aliens[a].x 266. player.laserActive - 1 
+ movex, aliens[a].y + movey), duration=0.5, 267. player.lives - 3 
tween-'linear') 268. player.name = "" 
217. if randint(0, 1) -- 0: 269. level = 1 
218. aliens[a].image = “alieni" 270. 
219. else: 271. def initAliens(): 
220. aliens[a].image = "alienib" 272. global aliens, moveCounter, moveSequence 
221. if randint(0, 5) -- 0: 273. aliens - [] 
222. lasers.append(Actor("laser1", 274. moveCounter - moveSequence - 0 
(aliens[a].x,aliens[a].y))) 275. for a in range(18): 
223. lasers[len(lasers)-1].status = @ 276. aliens.append(Actor("alieni1", (210+ 
224. lasers[len(lasers)-1].type = @ (a % 6)*80,100+(int(a/6)*64)))) 
225. sounds. laser.play() 277. aliens[a].status = ð 
226. if aliens[a].y > 500 and player.status == 278. 
0: 279. def drawClipped(self): 
227. sounds.explosion.play() 280. screen.surface.blit(self. surf, (self.x-32, 
228. player.status - 1 self.y-self.height«30),(0,0,64,self.height)) 
229. player.lives - 1 281. 
230. moveSequence 4-1 282. def collideLaser(self, other): 
231. if moveSequence == 40: moveSequence = @ 283. return ( 
232. 284. self.x-20 « other.x+5 and 
233. def updateBoss(): 285. self.y-self.height«30 < other.y and 
234. global boss, level, player, lasers 286. self.x+32 > other.x+5 and 
235. if boss.active: 287. self.y-self.height+30 + self.height > 
236. boss.y += (0.3*level) other.y 
237. if boss.direction == 0: 288. ) 
238. boss.x -= (1* level) 289. 
239. else: boss.x += (1* level) 290. def initBases(): 
240. if boss.x « 100: boss.direction - 1 291. global bases 
241. if boss.x > 700: boss.direction = 0 292. bases - [] 
242. if boss.y » 500: 293. bc = ð 
243. sounds.explosion.play() 294. for b in range(3): 
244. player.status - 1 295. for p in range(3): 
245. boss.active - False 296. bases.append(Actor("base1", 
246. if randint(0, 30) == @: midbottom=(150+(b*20@0)+(p*40) ,52@))) 
247. lasers.append(Actor("laser1", 297. bases[bc].drawClipped - 
(boss.x,boss.y))) drawClipped. get  (bases[bc]) 
248. lasers[len(lasers)-1].status = @ 298. bases[bc].collideLaser = 
249. lasers[len(lasers)-1].type = @ collideLaser. get  (bases[bc]) 
250. else: 299. bases[bc].height - 60 
251. if randint(0, 800) -- 0: 300. bc 4-1 
252. boss.active - True 301. 
253. boss.x - 800 302. init() 
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Coding games on the 
aspberry P11n C/C++ 


Brian 
Beuken 


Very old game 
programmer, now 
teaching very young 
game programmers 
a lot of bad habits 
at Breda University 
of Applied Science, 
in the Netherlands. 


magpi.cc/YxaUVQ 


| You'll Need 


» Code::Blocks 
sudo apt-get 
codeblocks 


» GLM installed 
previously 


> stb image.h 
installed previously 


But the future is 3D 


et's make some use of those crazy matrices. 

We've clearly demonstrated that we can 

avoid a lot of the crazy maths when working 
in 2D (see last issue's guide) but though it's 
slightly overkill, using matrices gives us access to 
a lot more features and abilities. So let's see how 
far we can push things. 


The third dimension 
We have really been working in 3D already; our 
tiles and sprites are in fact 3D, but only in the 
same way a drawing on a flat piece of paper is 3D. 
Also, we've been using a viewpoint or camera view 
that has been effectively placed directly above the 
paper - keeping our Z coordinate at zero has let 
our 3D system happily display in 2D. 

But what if we were to do a bit of origami on 


our paper and tu 


rn our flat paper into a nice cube? 


That's more or less the principles of 3D. Well, 


then we have to 
*how is the cube 


make some decisions, such as 
placed in spacee’, ‘on what axis 


or axes does it rotate around? ... If we look down 


on our cube and 


twiddle it about in our hand, we 


can see that different faces of the cube are visible 


at different time 
3D sense of dept 
the points or ver 


s, and - also important to get a 
h with our eye - we notice that 
tices of the cube are at different 


distances to our eye. Hopefully we can get a sense 
that our cube points can be tracked on x, y, and z 


€ 


points ‘relative’ 


to our eye, or camera. 


Figure 1 shows how a 3D scene can be 
‘projected’ to a 2D flat space, due to being viewed 
relative to the camera. 
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Now consider what happens if you keep your 
head/eye perfectly still, and you move your 
cube up and to the left a bit. The cube is moving 
through space and, if our eye is still, it is moving 
off our screen, but we will maybe see a bit more of 
the faces on the front and right of the cube as it 
moves off. 

So, as you can see, that's a bit complex. But 
wait, it gets worse: imagine this time that you 
hold the cube still, then move your head up 
slowly. In terms of your field of view, the cube 
is going to move down. Now imagine the cube 
rotating in your hand! 

So there are two ways to move the cube in our 
field of view. But what if we do both at the same 
time? Now we've got two things moving: the cube, 
rotating and translating in space, and our eye, 
which is also capable of rotating and translating 
in space. We start to get the idea that what we 
see in our field of view very much depends on the 


relative position of all the objects 


in our space. 


Also, we need to ignore things tha 


t we can't see: 


if our cube is behind us, clearly we can't see it. 
Now instead of our eye, our computer has to 


convert things in its idea of space, 


into images 


on our Screen - or as we call it, our ‘view plane’. 


TopTip & 


Learn to love matrices 


Matrices give us a way to transform any point 
in space, and in many different ways. 


And that view of the world changes depending on 
where and how you view it (Figure 2, overleaf). 

The maths involved is frankly staggering, but 
with matrices there is a very simple way to work 
out where on a screen each of our cube’s eight 
corner points should be: 


Transformed Vertex = VxM 


Yup, just VxM, where V is the vertex and Misa 
transformation matrix. It's true that there's still 
a massive amount of calculation going on under 
the hood, but we can be confident our maths 
library is handling that, and therefore we can view 
the concept in a simple, abstract way. It's a bit 
like offering someone a meal without going into a 
long description of its constituents and how you 
prepared and presented them. 

We can simply multiply each vertex point 
by a matrix to get a new point, which is going 


m A great feature of matrices is that we 
can combine - or 'concatenate' - them, 
by multiplying them in specific ways @ 


to represent a transformed point. The vertices 
might be different for each point, but the 

matrix is always the same. So computers, and 
GPUs especially, are designed to be effective at 
using and reusing this matrix and can calculate 
hundreds of thousands of new transformed 
vertices in rapid time. Stretching a texture on the 
UV points of those vertices, as we did with our 
tiles, gives us a sense of a solid 3D object. 

A great feature of matrices is that we 

can combine - or ‘concatenate’ - them, by 
multiplying them in specific ways. So we can 
concatenate matrices and get the resulting matrix 
to produce the results of two, three, four, or more 
separate matrix multiplications. 

Our matrices mainly focus on translation, 
scaling, and rotation, and both our camera and 
model can have this. So, by multiplying a camera 
matrix containing its rotation and location 
(scaling isn't really important to our camera yet) 
with our model's matrix, we get a single matrix 
that transforms any vertex in our 3D space. 
There's a tiny complication related to the fact 
we want to maintain a sense of perspective in 
our depth so that we can tell things are far away, 


because they will naturally appear to get smaller. 
This is also possible to represent in a matrix, 
called the ‘projection matrix’. 


Please, no more maths 
Now that’s not a full explanation of the maths - 
and it would take a lot more than four pages to 
really get into it - but as a simple explanation, 
we simply need to know that we have to create 
matrices for each model, for one camera, and also 
keep a fairly consistent projection matrix. 
Once set up, we can feed our shaders with the 
model's relative values, and the specific matrix 
for its position, and boom... we get 3D! 
Review the demo code, build and run it. At first, 
it all looks almost exactly the same. But press Q 
and A: these control a camera as it goes up and 
down in space, but keeping its gaze firmly on Bob. 
Code-wise, our code has not really changed 
much: we are still playing with a 2D map in a 2D 
space. We're simply cheating a bit to visualise our 
tiles as cubes, and our sprites as a flat billboard 
which always faces the camera. 
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A. Figure 1 Projection 
lets us visualise a 
World as a screen 


TopTip è 


Don't type 
in models 


Although we have 
typed in cubes, 3D 
models can get 
very complex. It's 
much better to use 
a 3D modelling 
package for 
anything more 
than a cube. 
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A. Figure 2 Our view of 
the world depends on 
from where we see it 


It's a cool effect and it shows how 3D is not a 
massive leap - we just have to become a little 
more comfortable with working with cubes and 
spheres, rather than squares and circles. 


Cleaning up the niggles 
However we display our images, we still need our 
logic to be tighter and smoother. We want to take 


m Even the most powerful processors get 
bogged down by having to do too many 
unnecessary things Ø 


TopTip è 


Start to 
think relative 


We still have a 2D 
map, but when 
we switch to full 
3D, the concepts 
of left, right, up, 
and down will 
lose much of 
their meaning. 


more care of how we hit walls and make our jumps 
a little less frustrating. It’s not really a massive 
change, just an acceptance that we may have to do 
more than one test. Our Bob sprite is bigger than 
a tile, so if we only test his top or bottom, or even 
his middle corners, we may miss other points 

of contact. 

Scanning a few points of contact makes sense, 
though, but only in the direction of travel. Take a 
ook at the player's movement code, and you will 
see we scan more carefully. 

But, notice that we don't take quite so much 
care with our baddies? This is simple an economy 
of effort. We are going to place those baddies at 
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specific locations, so it’s logical to put them in 
places where we can comfortably predict the type 
of collision that will be most effective, in this case 
only testing their feet. 

If, however, we wanted them to be much more 
general and placed anywhere, then we could adapt 
Bob’s collision logic to work on them. There’s a 
golden rule in coding games: never do more than 
you need to. Processors are very fast and can doa 
lot of processing in a single frame, but even the 
most powerful processors get bogged down by 
having to do too many unnecessary things. So at 
all times, keep your code as simple as possible to 
achieve only the result you need. 


Multiple maps 
Having a more playable map in the new demo is 
great: it lets us see that our code works and it's 
shaping into a nice game. But one map on its own 
is going to get boring, so let's have multiple maps 
and let's also have different sizes. 

Keeping track of the maps is a little tricky: 
we've written most of our code referring totally to 
Map2 - in effect, our code is hard-wired to only 


use Map2. That's not very effective; we need to be 
able to let our code use any map, at least a map 
that conforms to our definition of a map. 

By making the map a variable, it’s a simple job 
to plug in a new map, so long as they are all the 
same size. In fact, we can keep a whole range of 
them. It does get a bit more complex if you don’t 
know the size, but really if you have an unknown 
size of an array, we should really use the much 
more useful STD::vector structure, which is a 
dynamic array we can set to be any size we need. 


Next time 

Our very simple little game is complete, and 
although you may not realise it, you've used 
a number of basic concepts to make this work 


which are common in many game genres. In our 
next - and sadly final - article, we'll look back at 
these concepts and show you how to adapt them 
to work on almost any kind of game, and give tips 
on improving performance. 
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TopTip è 


Learn more about C 


exe 
Brian has a whole book on the THE FONDAMENTALS OF 
à 7 C++ G 
subject of making games C and istic ies PROGRAMMING 


C++, called The Fundamentals of 
C/C++ Game Programming: Using 
Target-based Development on 
SBCs. Grab it here: 
magpi.cc/nUkjEt 


Try to improve 
your maths 


Still a valid tip 

from last time: 
maths is the most 
scary thing in 
coding, but a small 
understanding can 
go a long way. 


Connecting Raspberry Pi 
to FPGA through USB 


CON-FMC™ supports USB 3.0/2.0. 


CON-FMC™ supports Ubuntu, CentOS, and Raspbian. 
CON-FMC™ supports C/C++ API such as BfmRead() and BfmWrite(). 


CON-FMC™ supports off-the-shelf FPGA board with FMC connector. 
CON-FMC™ supports FIFO interface and AMBA AXI/AHB/APB buses. 


CON-FMC™ supports CPU-to-FPGA offloading. 


For additional information contact at contact@future-ds.com or 
visit www.future-ds.com/CON-FMC 


FUTURE 


Design Systems 
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Add vision with the 


The Pi Camera Module should be an essential piece of 
any digital maker's kit, as it can be used in a wide variety 
of projects. Wesley Archer puts us in the picture 


G ive your Raspberry Pi the gift of sight with We've seen many exciting builds take advantage 


a Pi Camera Module (magpi.cc/xSXqyL). of these, but being able to see what is happening 
This handy attachment connects directly around your Raspberry Pi is very simple with the 
to the Raspberry Pi and is used in a wide range of Pi Camera Module. These are some of the best 
vision-based projects. projects for beginners. They're easy to set up and 
Using a Raspberry Pi to monitor its produce visible results. 
surroundings is a fascinating subject, especially Using the Camera Module is a great way to 
with the huge array of sensors, accessories, HATs, add an extra dimension to most projects. Let's 
and pHATs available. get started... 


Regular or w Camera Module V2.1 w Camera Module NoIR V2.1 


night vision? 


e O6 
2 


J 


The Pi Camera Module has two 
variants - the standard version 
and the NolR version, which 
has the infrared filter removed 
to allow the camera to detect 
infrared light. It makes a great 
night-vision camera when used 
with an IR light source! 


a 
- 
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Camera V2.1 
Camera v2 
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The Camera Module is small The small lens captures still 
enough to fit inside bird- images and video, which are 
boxes or small project boxes saved to the Raspberry Pi 
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SETUPYOUR 
CAMERA MODUL 


Before you can start snapping away with the Camera Mo 
you'll need to connect it to the Raspberry Pi and test it out 


You'll Need 


» Pi Camera 
Module 
magpi.cc/ 
kAtsHn 


» Pi Zero Camera 
Adapter (optional) 
magpi.cc/ 
uAUbdp 


» microSD card 


» Raspbian 


Disable LED 


The V1 Camera 
Module lights a 
red LED when 
activated (the V2 
Camera doesn't 
have one). To 
disable this, add 
disable camera 
led=1 to the 
/boot/config.txt 
file (and reboot). 


> While small, the 
Camera Module takes 
high-resolution photos 
(up to 3280x2464 pixels) 
and captures HD video 
(up to 1080p) without 
breaking a sweat 


etting up a Camera Module couldn’t be 
S easier. You attach the Camera Module 

directly to the Camera Serial Interface (CSI) 
port on the Raspberry Pi board. 

Connecting it to your Raspberry Pi is the same 
whether you own a Raspberry Pi 3+, a Pi Zero, or 
even an earlier Model B with 26 GPIO pins. 

However, if you are going to connect a Camera 
Module to a Pi Zero (1.3, W, or WH), you'll need 
to use a Pi Zero Camera Adapter. This is often 
sold separately (£4, magpi.cc/uAUbdp), and 
sometimes included with the Official Pi Zero 
case (magpi.cc/LECcmE). 

If you received a Pi Zero W free with a 
subscription to The MagPi (magpi.cc/subscribe), 
you will have got a Zero Camera Adapter cable free 
with your Pi Zero W and Starter Kit. 

Once you've got your Camera Module and 
Raspberry Pi, you use the cable to attach the two 
together. We'll show you how... 


Connect the cable to 

a Raspberry Pi 2/3/3+ 
On a full-size Raspberry Pi, you will need to 
connect the camera cable to the Camera port 
nearest the Ethernet port. Gently lift the small 
plastic clasp on the Camera port and connect the 
camera cable with the blue part facing towards 
the Ethernet port, then gently push the clasp back 
down so it holds the cable in place. 


Connect the cable 

to a Pi Zero W 
The Pi Zero W has a smaller Camera port, but the 
official Pi Zero case usually includes the cable. 
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As with the full-size Raspberry Pi, gently pull 

the plastic clasp and then slot the camera cable 

in - you should see the white part facing upwards. 
You'll know if the cable is in correctly if the camera 
Works, but it is best to check before booting your 
Raspberry Pi. 


Connect the 

Camera Module 
Similar to the way the camera cable connects to the 
Raspberry Pi, gently pull the small plastic clasp on 
the Camera Module and then slot the other end of 
the camera cable into the port - this time the blue 
part should be facing you, with the camera lens 
pointing the opposite direction. Gently close the 
clasp, locking the cable in place - the clasps can be 
fragile, so handle with care. 


The cable connects 
the Camera Module to 
the Camera port on the 


Raspberry Pi board 


The cable is flexible, enabling you to position 
and attach the Camera Module wherever you 
want for your project. You can also buy different- 
length cables to suit your project 


Enable the Camera Module 

By default, the Camera Module is not enabled 
in Raspbian, but it is very easy to enable. If you 
have your Raspberry Pi connected to a mouse, 
keyboard, and monitor, you can use the Raspberry 
Pi Desktop to enable the Camera function. Click 
on the raspberry icon (top left) and choose 
Preferences > Raspberry Pi Configuration. Click the 
Interfaces tab and set Camera to Enabled. Click OK; 
when prompted to reboot, click Yes. 


System Interfaces || Performance | Localisation 
Camera ©) Enabled Disabled 
E SSH *) Enabled Disabled 
= VNC. Enabled *) Disabled 


Enabled Disabled 


12C; Enabled Disabled 


Serial Port Enabled Disabled 


Console: 


1-Wire: Enabled Disabled 


Remote GPIO Enabled Disabled 


Cancel OK 


Enabling via SSH 

If you are accessing your Raspberry Pi over 
SSH, you'll need to enable the camera via the 
command-line Raspberry Pi configuration tool 
instead. Enter the following in a Terminal window: 


sudo raspi-config 


Now select ‘5 - Interfacing Options > P1 - Camera’ 
and choose <Yes> to enable the camera. Press 
ENTER on <Ok> and choose <Finish>. When 
asked to reboot, choose <Yes>. We’re now set to 
snap away. 


Test the Camera Module 

Before diving into a project, it’s worth testing 
your Camera Module works as expected first. Open 
a Terminal and enter this command: 


raspistill -o /home/pi/hello. jpg 


Smile for a few seconds - you can see yourself on 
the live camera preview - while the photo is taken 
and saved to the /home/pi directory. Why not open 
it in File Manager to see the results? 
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A. Pi Zero owners will 
need a Pi Zero Camera 
Adapter to connect the 
Camera Module to the 
smaller Camera socket 
on the board 


Raspberry Pi 


Camera Case 


Using a full-sized 
Raspberry Pi? Why 
not buy a Raspberry 
Pi case designed to 
accommodate the 
Camera Module, 
such as the PiShell? 


<4 You must activate 
the Camera interface 
in Raspberry Pi 
Configuration before 
using the camera 
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CAMERA MODU 


SETTINGS 


Get the most out of your Camera Module by tweaking 
the various settings and creating different effects 


You'll Need 


> Pi Camera 
Module 
magpi.cc/ 
kAtsHn 


> Pi Zero Camera 
Adapter (optional) 
magpi.cc/ 
uAUbdp 


>microSD card 


> Raspbian 


he Camera Module doesn’t just snap photos 
| — it also records video - but did you know 

that there are lots of different settings that 
can be applied to customise how the photo or video 
appears? In this guide, we're going to explore some 
of the settings and commands that can be used 
to tailor how you use the Camera Module in your 
project, and we'll explore some of the more quirky 
features too! 


1 Adjusting resolution 
and brightness 

The latest Camera Module has a maximum 
resolution for a photo of 3280x2464 pixels, but 
images this large can take up a lot of storage space 
over time and take longer to process by the Pi. 
Fortunately, raspistill, the program that captures 
photos on our Pi, allows us to specify the photo 
resolution very easily. For example, you can set the 
width (640 pixels) and height (480 pixels) using 
the -w and -h parameters accordingly. You can also 
specify the brightness with the -br parameter and 
a value between 0 and 100. The image above was 
taken with the NoIR Camera Module (hence the 
odd colours) using: 
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raspistill -w 640 -h 480 -br 40 -o /home/ 
pi/hello.jpg 


This demonstrates how you can take a smaller 
photo (640x480 pixels) with a brightness of 40, but 
feel free to experiment to see what works best. 


Pi Camera 12-10-2018 0950:03 


2 Adding text 


If you’re old enough to remember actual 
printed photographs, then you may have noticed 
that some cameras added the date and time 
to record when the photo was taken. If you’re 
too young to remember, don’t worry as you’ve 
just learned something new! With raspistill 
you can add your own text to your photos too, 
using the -a or --annotate parameter. Take the 
following example: 


raspistill -a 4 -a "Pi Camera %d-%m-%Y 
*X" -o /home/pi/text. jpg 


The first -a 4 part sets the bitmask notation in 
the metadata to record the time (more info on that 
here: magpi.cc/2egcYup). 

The second -a part includes our custom text 
(Pi Camera) and formats the date into dd-mm-yy 
(%d-%m-%Y) before adding the time (XX) and then 
saving the photo the Raspberry Pi directory 
as text.jpg. 
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Camera 


Essentials 


We've only just 
Scratched the 
surface of what 
the Camera 
Module can do 

in our guide, so 
why not take 

a look at The 
MagPi Essentials 
Camera Module 
Guide for a more 
comprehensive 
overview of all the 
commands, hints, 
and tips to ensure 
you get the most 
out of it? 


magpi.cc/ 
camera- 
essentials 


Add image effects 

Another quirky feature of raspistill is that 
you can add image effects to photos taken by the 
Camera Module, such as inverting the colours to a 
negative, making the photo look like a sketch, or 
even adding a cartoon effect. Now, before you all 
get carried away, some of the effects can be a little 
hit-and-miss, but they can add a cool look to your 
photos nonetheless! This is done by adding the 
-ifx parameter along with the desired effect (full 
breakdown available here: magpi.cc/SuuEC]). 

The following example applies a negative effect 

to the photo, as well as adding our custom text, 
date, and time: 


<4 Make the photo 

look like a watercolour 
painting instead of a 
negative with the -ifx 
watercolour parameter 


<4 Embossing is the 
process of creating a 
raised image, usually 
in paper or card. You 
can recreate the effect 
with the -ifx emboss 
parameter 


As you can see from the image above, this is an 
interesting effect! Be sure to try out the sketch and 
emboss commands too. 
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CAMERA MODUL 
PROJECTS — 


We've selected six Camera Module-related projects to tr 
If you need some inspiration, then take a look at the pick « 


Stop-motion animation 

Stop-motion animation - think Wallace & 
Gromit - is where a series of photographs are 
taken, but with minor changes made to the 
‘scene’ being filmed. The scene is changed 
slightly between shots - known as frames - 
and when they are all stitched back together 
afterwards, the illusion of animation is 
complete! In this fantastic tutorial, learn how to 
add a button to your Camera Module setup and 
create your very own stop-motion animation! 
More info: magpi.cc/KiYbdb 


€ 


Pi Zero LED case hack 

As you now know, the NoIR version of the 
Camera Module has the infrared filter removed 
from the lens so that it can detect infrared light. 
This makes it an ideal choice for projects in the 
dark. In this neat project, you can easily add IR 
LEDs to provide additional infrared light, so that 
your pictures capture more detail in the dark - 
and all housed within the official Raspberry Pi 
Zero case, too! 

More info: magpi.cc/xCozST 


Rodak: a Pi in a Kodak 

Taking photos is what the Camera Module is 
designed for, so what better way to do that than 
to upcycle an old Kodak Brownie Flash III camera 
to house a Raspberry Pi Zero, like Alex Ellis did? It 
also contains some additional components, such 
as a LiPo battery for power-on-the-go, a push- 
button to trigger the camera, and a cool NeoPixel 
status LED to show you when the camera is ready 
to fire again! 

More info: magpi.cc/sAxjyc 
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Google Vision: Camera Tell 

This cool project, by Dan Aldred (aka TeCoEd), 
makes use of the Google Vision cloud service. If you 
haven’t heard of Google Vision, it uses artificial 
intelligence to analyse an image and tells you 

what is in it! Dan takes this project even further by 
creating a portable camera - housed inside an old 
disposable camera - that uses a Camera Module, 

as well as Google Vision to announce what you have 
just taken a photo of. 


ju asus infa: maori 
IMoOre info: Magpl 


Home CCTV with motionEye0S 

If you missed our Home Security feature in issue 
73 (magpi.cc/73), then you should definitely 
check out the handy motionEyeOS, which is 

a standalone operating system that runs on 
Raspberry Pi and allows you to easily create your 
very own home CCTV setup with a few clicks. Once 
the OS image is flashed to your microSD card, you 
will be up and running in no time and be able to 
keep an eye on your home when you are away. 


More into: mag] 


cc/mpLqjp 
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Make a parent detector 
Do you suspect your parents sneak into your 
room when you’re out? Do they play on your 
Xbox or PS4 without your permission? Then 
follow this tutorial and build a parent detector, 
using the Camera Module and a PIR (passive 
infrared) sensor, and catch them red-handed! 
Learn how the PIR sensor can trigger the Camera 
Module to take a photo whenever it detects 
movement, then see how your parents react 
when confronted with the evidence. 

ag c/nlaOD 


More info: magpi.c De 
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Cube ‘Bit 


> Atronix » magpi.cc/PjGgkp » From £22 / $24 


Inspired by the Cubert project, this NeoPixel matrix can 
produce impressive 3D visual effects. Phil King sees the light 


oming in three main size options - 3x3x3, to the upper one's DOUT, so those corners have 
C 4*X4X*4, and 5x5x5 - the Cube:Bit is a 3D alternating missing pillars as you build up. Even 
matrix of RGB NeoPixels. 4tronix tells so, the end result is a solid-feeling cube that you 
PIXELS: us that the product was inspired by Lorraine can carry around and even turn over in your hand 
125 NeoPixels Underwood's Cubert project (magpi.cc/djMRkX), without any worries about it falling apart. 
(5x5x5 model although the Cube:Bit is a whole lot smaller than 
DIMENSIONS: that giant creation. The 5x5x5 model (£90 / $98) Power and control 
89x89x89 mm we tested measures 89 mm along each side. While it's possible to power and control the 
(5x5x5 model) First, however, you need to put it together, Cube:Bit manually - by connecting the metal 
: as it comes in 2D square ‘slices’ (supplied ina stand-off ‘legs’ of the bottom slice to a 5V 
Eid dul posh-looking jewellery-style box). Assembly is power supply, ground, and Raspberry Pi or 
micro:bit quick and fairly simple, following the online guide ^ microcontroller, using crocodile clips - it's a 
connector, (magpi.cc/EujyXH). Each slice is mounted on the lot easier to simply mount it (using stand-offs) 
and others one below using the supplied metal stand-off on the optional Cube:Bit Base (£12 / $13). The 
pillars and screws. You just need to be careful to latter features four 5 V power connection options: 


flip each alternate slice (helpfully, they'relabelled ^ micro USB, 2.1mm DC jack, GVS pins, and crocodile 
A-side and B-side) and make surethe5V and GND clip positions. 

corners match, while the lower slice's DOUT (data 
out) connects to the DIN on the one above. Only 
three pillars are used to connect each slice, since 
you don't want to connect the lower slice's DIN 


P The family of 
Cube:Bits, from 
3x3x3 to 5x5x5 
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This will in turn power a connected Raspberry 
Pi or other microcontroller. Along with a micro:bit 
slot, there’s a female GPIO header for Raspberry 
Pi. Note, however, that the nearby metal pillars 
prevent a full-size Pi model being mounted 
directly, so you'll need to use a ribbon cable (or 
jumper wires to 5V, GND, and GPIO 18 - the only 
pins used). A Pi Zero, however, can be mounted 
directly on the Cube:Bit Base header, albeit with 
the Zero's board sticking out of the side. 


Snaking pixels 
In essence, the Cube:Bit is a string of NeoPixels, so 
you can control them with any standard WS2812B 
compatible code. On the Pi, this necessitates 
installing the rpi_ws281x Python library - directly 
or by using the curl script for Pimoroni's Unicorn 
HAT, for example. 


W Stack 'em high! You can theoretically 
add as many extra slices as you want 
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Since the ‘string’ of NeoPixels snakes up and 
down each slice before connecting to the one 
above, this would make controlling them manually 
rather mind-boggling. Fortunately, 4tronix has 
created a Python library which can be downloaded 
with a one-line Terminal command. This maps the 
pixels logically so that you can easily address them 
with x, y, and z coordinates. So it might even be a 
useful aid for educators teaching 3D geometry. 

At the time of writing, the Python library only 
came with a couple of code examples: test.py for 
a rainbow effect and individual pixel test, and 
purpleRain.py which sees purple ‘raindrops’ 
falling from the top to the bottom of the cube. The 
micro:bit has a larger range of MakeCode examples 
to show what Cube:Bit can do, including effects 
based on rotating the cube (possibly achievable 
using an Enviro pHAT or similar on the Pi). 

We also thought of using it as a fancy VU meter 
for music. Going one step further, Robin Newman 
has created a project with the Cube:Bit LEDs 
controlled from Sonic Pi using OSC messages 
(magpi.cc/RkxuDU) and even via a smartphone 
app. So there are plenty of possibilities. W 


A The multicoloured 
matrix produces some 
dazzling displays 


Verdict 


Easy to assemble, 
if not quite so 
simple to program, 
the Cube:Bit is 
pricey for the 
larger sizes - with 
the Base costing 
extra - but can 
produce some 
unique 3D visuals. 
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DAC+ DSP 


Raspberry Pi audio to another level, 
bringing digital signal processing 
(DSP) to a reasonably priced DAC (digital-to- 
analogue converter). 
Regular readers may notice that it bears a lot of 
similarity to the recent Beocreate board (reviewed 
in The MagPi #72, magpi.cc/72). The DAC+ DSP 
has much of the technology from the more 
expensive Beocreate (£149), but with only two 
RCA outputs (as opposed to the Beocreate’s four). 


H iFiBerry’s new DAC+ DSP hopes to take 


Wired for sound 
We found setup relatively straightforward. The 
board attaches directly to the GPIO pins of a 
Raspberry Pi 2/3 or Pi Zero, from which it draws 
its power. We tested it out with a Pi Zero W. 
OSMC works right out of the box and LibreELEC 
required a one-line tweak to the config.txt file. 
HiFiBerry hadn't got the online documentation up 
during our review, but it has detailed setup guides 
for all its other products and we found following 
the regular DAC+ guide good enough to get going. 


76 | magpicc | DAC: DSP 


> HiFiBerry » magpi.cc/ENHNgK » £60/ $80 


DSP is where things get interesting. You can 
affect the digital audio output, adding your own 
customisations and effects with code. 

HiFiBerry has a GitHub repository with a 
range of software options for DSP boards 
(magpi.cc/bzizRQ). One interesting option is 


M You can affect the digital 
audio output, adding your 
own customisations and 
effects with code Ø 


to use REW (Room EQ Wizard, roomeqwizard.com) 
software to analyse the acoustics in your 
room (magpi.cc/xJaOiu). 
You can also set up a speaker crossover; 
this takes the single digital input signal and 
creates multiple output signals of high-, 
mid-, and low-range frequencies that can 
be tweaked (magpi.cc/gbvAXa). El 


ANALOGUE 


OUTPUT: 
2 x RCA 


DIGITAL 1/0: 
Input up to 
96kHz, output 
up to 192kHz 


DSP: 
300MHz 


SAMPLE RATE 
CONVERSION: 


Asynchronous 
sample rate 
converter 


OTHER: 
EEPROM 


Upcycle old speakers and add smarts to 
an analogue stereo with powerful digital 
signal processing. By Lucy Hattersley 


Verdict 


We like this board 
a lot. It offers all 
the joy of a high- 
end DAC with an 
additional layer 

of coding for 
digital audiophiles. 
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HackSpace 


TECHNOLOGY IN YOUR HANDS 


1 NEW MAGAZINE 
me MODERN MAKER 


ISSUE #12 


OUT NOW 


hsmag.cc 


WE Magri | REVIEW 


10 Best: 


Raspberry PI 
Starter Kits 


New to Raspberry Pi? Here are 
some essential beginner's kits... 
W are always a few things you need to get 
to go with it. A microSD card, cables, 


keyboards, electronics components, etc. With 
these starter kits, you can kick-start your learning 
with Raspberry Pi. Hl 


hen you first get a Raspberry Pi, there 


Pm NE. 


Official 
starter kit 


TYPE: Simple and clean 


This smart starter kit from Raspberry 
Pi includes a Raspberry Pi 3, as well 
as an official power supply, case, 
mouse, and keyboard. You even get 
Carrie Anne Philbin's excellent book, 
Adventures in Raspberry Pi, to start 
your Pi journey with. 


> £119 / $140 
> magpi.cc/DLrEkB 
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Raspberry Pi 3B+ 
essentials kit 


TYPE: Just the essentials 


This kit also comes with a Raspberry 
Pi, a slimmed-down Pibow case, a 
power supply, and a microSD card. 
The very essentials you'll need to 
get your Raspberry Pi running - 
along with a free Pi sticker. 


> £58 / $63 
> magpi.cc/PVrMLf 


Raspberry Pi 3 B* 
Starter Kit 


TYPE: A bigger kit 


This bigger starter kit from Pimoroni 
includes a keyboard, mouse, 
stickers, a Blinkt! light strip, and 

a getting started guide! It's a nice 
beginner's kit that comes in a very 
pretty box, and those stickers are 
very important. 


> £90/ $98 
> magpi.cc/TGNWLY 


Retro Gaming Kit 


TYPE: Retro fun 


A lot of people love to use their 
Raspberry Pi to play retro games on, 
and this kit is specifically designed 
to help you quickly make a great- 
looking Pi-powered console. The 
NES-style case is a nice touch. 


> £76 / $102 
> magpi.cc/RmLPCn 


Media Center Kit 


TYPE: Improve your TV 


As popular as retro gaming is on 
the Pi, home theatre PCs and media 
centres are even more popular 
among the community. This kit 
comes with all the essentials to get 
your HTPC Pi going, along with a 
lovely remote to control it all with. 


> £76 / $102 
> magpi.cc/SUBydV 


GoP1iGo23 


TYPE: Robot for beginners 


Raspberry Squid 
combo pack 


TYPE: A simple kit 
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Electronics 
Starter Kit 


TYPE: More electronics fun 


While not the cheapest robot kit 
around, we think this is one of the 
best robot starter kits, with plenty of 
resources to learn how to use robots 
available for it as well. You can then 
use the base to make bigger and 
better robots. 


> £76/$100 
> magpi.cc/iGqLbs 


We really like this kit from Monk 
Makes as it's a good introduction 

to electronics on the Raspberry Pi, 
which means it deserves a place 
on this list for people looking to get 
their start in using the (sometimes) 
mysterious GPIO pins on their Pi. 


> £10/$15 
> magpi.cc/LdhiFy 


If you want to go beyond the 
Raspberry Squid, this kit opens up a 
whole world of basic electronics for 
you to experiment with. Each kit also 
comes with a load of quick projects 
printed on cards, with handy circuit 
diagrams to follow as well! 


> £13/8$18 
» magpi.cc/BdmsoY 


pi-top 


TYPE: All-in-one 


Quite an extreme concept of a 
starter kit, the pi-top is a laptop you 
build yourself that uses a Raspberry 
Pi at its core. You get power, a 
Screen, a keyboard, and a mouse 
along with the Pi, and it's even got a 
chargeable battery so it's portable. 
There's plenty of learning software 
on it as well! 


> £260/ $320 
> pi-top.com 


The official 
Raspberry Pi 
Beginners Book 


TYPE: Kit and book 


This is not just a book full of 
excellent tutorials to get your 
started on your Pi journey- it's 

also a Pi Zero kit! It comes with a Pi 
Zero W, adapter cables, a preloaded 
microSD card, and a case! 


> £25/$33 
> magpi.cc/FeSHGb 


& RASPBERRY PI 


THE Official 
RASPBERRY PI 
BEGINNER'S BOOK 


Gi Staaten E PI 


e. pocket-sized desktop computer! 


FROM THE MAKERS or MagPi 


PIZERO 


THE OFFICIAL RASPBERRY PI MAGAZINE 


FREE RESOURCES 


There are loads of free tutorials on the Raspberry Pi 
website (rpf.io), along with all the free back issues of 
The MagPi on our site (magpi.cc), which you can use 
to learn everything you need to know about the Pi! 
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MME Magri | RESOURCES 


Learn Minecraft | 
with Raspberry P1 


David Crookes looks at the resources that help you 
find your way around this sandbox video game 


Mi i 


HACKING AND 
MAKING 


Hackıng and Makıng ın Minecraft 


Minecraft takes on a life of its 
own with a Raspberry Pi, thanks 
to it coming with an API. This 
allows you to create mods that 
link the game to the real world. 
It also lets you manipulate 
the structure using Python 
scripts, opening up a host of 
potential hacks. 

For a solid grounding in 
such matters, this entry in 
The MagPi Essentials collection 
is a blockbuster. It helps to 


The MagPi team 


Price: 

£3.99 (Free download) 
magpi.cc/ 
minecraft-book 


quickly build confidence, briefly 
introducing the basics of the 
game and how to get started 
before moving you straight 

into your first program and the 
fundamentals of the API. 

As well as understanding how 
to control and change any block, 
you'll learn how to code mini- 
games - including a fun two- 
player blast based on Nintendo's 
Splatoon. The book also covers 
the terraforming process that 


lets you create an entire world 
from a favourite block and the 
ability to play God by sparking 
a host of natural disasters. 
More than that, you'll be 
taught ways of making use of a 
Sense HAT, the GPIO pins, Sonic 
Pi, and JavaScript, all clearly 
and concisely explained. To aid 
your learning, there's a handy 
reference guide and annotated 
diagrams at the right moments. 
It's sure to level you up fast. El 


Coding tutorials 


Understand how to program 
virtual worlds 


WOLFRAM Ata a mee Q tah 


E} wotrram BLOG 


p Programming Minecraft on the Raspberry Pi 


A Use Python or Wolfram Language to create things in Minecraft 
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HOW TO PROGRAM MINECRAFT 
ON A RASPBERRY PI 

This tutorial explores Minecraft: Pi 
Edition's sole playing mode - Classic 
- and encourages you to write a 
'Hello World' program that can be 
adapted to transport Steve around 
the world. 

> magpi.cc/tUJpeB 


PROGRAMMING MINECRAFT 
WITH WOLFRAM LANGUAGE 
With this tutorial from the Wolfram 
blog, you can learn how to combine 


Minecraft and the Wolfram 
Language to create in-game 
structures that you can then look at 
from the air. 

> magpi.cc/CTMkgz 


BUILD A HOUSE IN MINECRAFT 
USING PYTHON 

This tutorial, taken from issue 68 of 
this very magazine, explains how you 
can design and build a house using 
Python. It comes with links to the 
project's complete code. 

> magpi.cc/xQwLLb 


Getting started 
with Minecraft 


Raspberry Pi Don’t worry if you’re an absolute 
Foundation Minecraft newbie, because this 
well-explained online resource 
Price: certainly has you covered. It 
Ha leads you by the hand to ensure plunge you into the Python 
magplice/DgIMOS that your first steps in the programming interface where 


game are as painless as possible each command and block of 
and, by splitting the guide over code is helpfully highlighted 


nine approachable sections, and breezily explained. 

each lesson has the right We like that it avoids 

amount of information without overcomplicating matters and 

feeling overwhelming. that results are seen on-screen 
The first four tutorials at every step. Ending with 

concentrate on installing the tips on how you can use your 

game and explaining the basics knowledge, it’s sure to whet 

of gameplay. The next four your appetite for more. M 


Minecraft quick-start 
guide and wiki 


Raspberry Pi Visit the official Minecraft The former shows you the 
Foundation website and, as well as being hardware and software needed 
able to download a free copy of to get Minecraft Pi up and 
Price: the game, you can access the running. The latter, however, 
Free ; . 5 ] í é A 
Raspberry Pi quick-start guide isa mine of information and 


magpi.cc/ VUUMpL 
magpi.cc/qEzamd 


and Minecraft wiki. one to bookmark for future use, 
particularly so for the handful 
of references at the end and, 
crucially, the details listed 
under Gameplay. 

Here you can find out how 
each block, tool, and plant 
works within the game, along 
with items that only work if 
modded. You can also discover 
any limitations, both within 


MINECRREV 


PT 
Oona miner tet 


[E nro the elements themselves and 
pan vigna san the Pi version of Minecraft. 
Gamepedia PRO and an . 
ad-free experience! Fully editable and expandable, 
ETIN it should go some way to 


answering your questions. El 
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Learn tricks via short 
video courses 


GETTING STARTED 
CODING MINECRAFT PI 
Carrie Anne Philbin's gentle 
and informative introduction 
to hacking Minecraft using 
Python is delightfully easy to 
follow thanks to an exhaustive 
approach that explains and 
shows each step in detail. 

> magpi.cc/zvXssK 


MINECRAFT PI EDITION 

- SURVIVAL MODE & 
PYTHON SCRIPTS 
Although poorly presented 
and spending large chunks 

in silence, this inspiring video 
is nevertheless educational, 
covering a Survival Mode mod 
while linking to Python scripts 
and assets in the description. 
> magpi.cc/dsMPqC 


HACKING MINECRAFT 

PI EDITION 

Superbly fronted with dollops 
of humour, this extremely 
approachable guide explores 
Python coding and the basics 
of the Minecraft API, with Lots 
of nods to extra resources and 


further information. 
> magpi.cc/dhuRid 
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DIY Games 
Console 


DOGEMASH X SEDI JO SABA OOF 


200 pages of 


THE Official 
RASPBERRY PI 


PROJECTS BOOK 


VOLUME 4 


Amazing hacking and making projects 
from the makers of MdgPi magazine 


Inside: 
@ How to get involved with the Pi community 
0 The most inspirational community projects 
@ Essential tutorials, guides, and ideas 


@ Expert reviews and buying advice 


E». i le e 
Gp magpi.cc/store 


plus all good newsagents and: 


WHSmith BARNES&NOBLE 


4 Available on the GET IT ON 
€ App Store P» Google Play 


ENNNEN Magri | INTERVIEW 


P The first Astro Pi mission 
involved ESA Astronaut 
Tim Peake 


Image Credit: ESA (European Space Agency) 
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Dave 


Honess 


Taking education to the stars with Space Dave 


> Category Educator | > Website www.esa.int 


> Day job 
áá M y earliest memory 
of being interested 
in space was 
watching Halley’s Comet 
as a nine-year-old,” Dave 
Honess tells us. We know Dave 
personally - he used to work at 
the Raspberry Pi Foundation as 
the man behind Astro Pi, and 
he’s even written a couple of 
tutorials in the magazine. 
These days, Dave works with 
the European Space Agency 
(ESA) to help organise their 


educational programs, and 
liaises with current Astro Pi 
programs at the Foundation. 
“Most of my career had 
nothing to do with space,” Dave 
admits. “But I always maintained 
an interest and enjoyed watching 
the ISS live streams in the early 
noughties when it was still being 
built. I never even imagined 
that the space industry could be 
a place where | might work one 
day; it always seemed so distant 
and abstract.” 


ISS and International Education Operations Coordinator 


Dave started working for 


the Raspberry Pi 
in early 2014, and 


Foundation 
soon found 


himself talking to folks 
from the UK Space Agency 


about a collabora 


tion that 


eventually became the first 


Astro Pi mission. 


“A friend worki 


ng at ESA in 


the Netherlands told me he 


was changing job 


s and that his 


position was going to become 
vacant.” Dave said. “We spent 
the phone 


about an hour on 


discussing all aspects of the work 
and... I decided to apply for the 
job. We have now moved to the 
Netherlands, and I have been 
working at ESA ESTEC [European 
Space Research and Technology 
Centre] since March 2018.” 


What's your favourite memory 
of working in the intersection 
of space and education? 


“It’s hard to pick just one. Pm 
really grateful to my former 
colleagues at the Raspberry Pi 
Foundation for allowing me to 
travel to Florida to watch the 
OA-4 rocket launch at Kennedy 


W This is Izzy the Astro Pi - 
its camera looks out of a 
window of the ISS 


own Astro Pi case here 
magpi.cc/EtDxAo 


Space Center in 2015 (the one 
carrying the original Astro Pi 
hardware to the ISS). I have 
strong memories of talking to 
the kids that have participated 
in Astro Pi, and hearing them 
say they now want to study 
aeronautics or astrophysics 
and suchlike.” 


Do you have any personal 
space-related plans? 


“I do, actually. Every year, ESA 
organises a staff trip to French 
Guiana to see the Ariane launch 
facility; you have to fund the 
flights yourself, but you’ ll get 
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A Find out how to print your 


INTERVIEW | MägPi MEE 


Astro Pi 


Hopefully you know by now 
that there are two special 
Raspberry Pi boards up on 
the International Space Station. Named Ed and Izzy, these two 
Astro Pi devices are designed to perform different kinds of 
experiments on the ISS: Ed lives in the Columbus module and 
uses a normal Camera Module, while Izzy has an IR Camera 
Module that looks out of a porthole down onto Earth. 

There are regular competitions for European schoolchildren 
to get their experiments run on these computers, with a couple 
even running right now! Head to astro-pi.org for more details. 


access to the launch site and 

a guided tour. If you're lucky, 
you also get to see an integrated 
launch vehicle sitting on the 
pad, and if you're really lucky 
your visit might coincide with 
an actual launch.” 


Any future work-related plans 
you can share with us? 


“Pm actually starting to believe 
that computing education is 
getting to a really good place 
now, not to say that we should 
take our foot off the pedal or 
anything. Astro Pi has developed 
into a mature educational 
challenge and I think it will go 
from strength to strength. I’m 
now turning my attention a little 
towards amateur radio, which 

is something that definitely 
doesn't have the uptake it needs. 
Radio remains the only way 

to communicate with all our 
spacecraft throughout the solar 
system, and organisations like 
ARISS and local HAM radio clubs 
are, in my opinion, becoming 
more and more necessary to 
attract new talent. It would be 
good to see educational material 
joining computing and radio 
topics. After all, all spacecraft 
can be boiled down to two 

main components: a computer 
and a radio!" El 
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Makers galore at the annual 
World Maker Faire! 


ast year you may remember that we went out 

with the Raspberry Pi Foundation to help out 

at their stall, getting young makers started 
with their maker journey through some fun Pi 
projects. While there was no official Raspberry Pi 
stall at World Maker Faire this year, that doesn’t 
mean there weren’t plenty of amazing makers 
there, and many of them were using a Raspberry Pi 
in their projects. Take a look! 


There were talks galore 


Do not feed this 
Seymour puppet 


Amazing 3D prints 


Some of the robots 
were very big 


This mini Landspeeder 
is perfect for popping 
down to Tosche Station 


Raspberry Pi didnt 
have a booth, but 
team members were 
still present a ; Credit: Lenore Edman 
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Credit: Lenore Edman 
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Announcing the ™ 
Raspberry Jam Big 


Birthday Weekend 2019! 


Celebrate the birthday of Raspberry Pi at your local Jam! 


Foundation coordinated over 100 community- 
led Raspberry Jam events around the globe. In 
a few months’ time, Raspberry Pi will be seven years 
old - and to celebrate, they're hosting another Big 
Birthday Weekend, which takes place all over the 
world on 2-3 March 2019. 
“Last year's event was a lot of fun!” Ben Nuttall, 
Raspberry Pi Community Manager, wrote on the 
Raspberry Pi blog. “We sent out starter kits and 
extra birthday goodies to participating Jams, and 
even put together a tweeting Raspberry Pi photo- 
booth for people to set up to share their events.” 
With the incredible support of the Raspberry 
Pi community, the Pi’s birthday was able to be 
celebrated in 40 countries, covering six continents - 
that is, every continent except Antarctica! Members 
of the Raspberry Pi Foundation team joined in with 
events in the UK, in California, across Europe, and 
elsewhere, despite unexpected UK snow-storms. 


F or Raspberry Pi’s birthday this year, the 


Get involved 
If you'd like to run an event for our Big Birthday 
Weekend, please head over to the Big Birthday 
Weekend 2019 page (magpi.cc/CrMUru) and sign 
up for the newsletter. That's where updates will be 
provided on what's going on and what you need to 
do to join in. 

If this sounds like it might be your kind of thing, 
but you've never done it before, there's plenty 
of time to get off to a gentle start and run a Jam 
before 2018 is out. When you join the newsletter, 
an invitation will be sent to you for the Jam maker 
Slack community, where you can get support from 
the Raspberry Pi Foundation and from wonderful 
Jam makers all around the world. They have lots of 
help and advice to offer people who are just starting 
out with their first Jam, and you'll be well rehearsed 
by the time the Birthday Weekend comes around. HI 
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Not sure where to start 
running your own Jam? A 
handy free guidebook all 
about setting up a Raspberry 
Jam can get you started. 
Head here to grab the PDF: 
magpi.cc/2q9DHfQ 
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Raspberry Pi projects you 
can crowdfund this month 


CROWDFUNDING 
A PI PROJECT? 
If you've launched an 


irresistible Pi-related 
project, let us know! 


magpi@raspberrypi.org 


A 


HackerTab Pro ITX & Raspberry Pi Retro 


Keyboard Computer Case 
“This is not a kit, it is a fully assembled professional 
tablet for industrial and field use,” states the We love seeing these sort of projects that create very 
Kickstarter page for the HackerTab Pro. It's a Compute retro-style cases for the Pi. The FUZE also does a 
Module 3-powered tablet that you'll be able to buy for similar thing, bringing the look of the BBC Micro to the 
€249 (£219/$287) and the makers reckon you'll be able Raspberry Pi. It's very apt, as the Pi was inspired by the 
to use it in industrial settings, as well as for retro gaming Micro. This project is made out of PVC and comes as a kit 
or an in-car computer. It looks pretty snazzy, too. that you can build yourself, or a more complete package. 
> kck.st/2pCngHr > magpi.cc/iTpMgJ 


Best of the rest! Here are some other great things we saw this month 


RASPBERRY PI ETCH ASKETCH | ROTATING VIDEO SCREEN SMARTER MIRROR 

This is extremely fun - motors controlled The Pi doesn't have a built-in gyroscope, It takes something a bit different to 

by a Raspberry Pi turn the knobs on an so, unlike a smartphone, you can't tilt it to get us to pay attention to a new magic 
Etch A Sketch classic toy. With a bit of change the orientation of a mounted mini mirror: there are so many of them! 
hacking and programming, maker Sunny display. This project takes the concept However, this build - which includes 
Balasubramanian managed to get the and goes a step further, with video that is useful hooks for storing keys, and a 

Pi to break down images sent to it into constantly playing at a specific orientation charging station - makes it a lot more 
instructions to draw it on the toy. as you move the Pi around. It's magic. useful than others! 


masice Etch Sketch? scum 


> magpi.cc/wuLzXa > magpi.cc/HrwPdB > magpi.cc/tZDPyp 
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Raspberry Jam 
Event Calendar 


Find out what community-organised Raspberry Pi-themed 


events are happening near you... 


01. MaltaPi 


© Saturday 3 November 

Q Vintage Computer Club Malta, Triq il-Fikus, Malta 
> magpi.cc/pTtuXW 

This weekend-long event is free and accessible, 

with room to show off your own projects. 


02. STEM Raspberry Pi for kids 

© Saturday 3 November 

Q Silver Spring Library, Silver Spring, MD, USA 
» magpi.cc/CKhMOq 

For folks living in Maryland and Washington DC, 
there will be several STEM classes related to Pi. 


03. Pi and More 

© Saturday 3 November 

Q Universitat Trier, Trier, Germany 

» piandmore.de 

Beginners and experts meet in a relaxed atmosphere 
for talks, workshops, and projects focusing on Pi. 


04. Thorpe Raspberry Jam 

© Saturday 3 November 

Q Thorpe St Andrew School, Thorpe St Andrew, UK 
» magpi.cc/jTCeUi 

Thorpe Jam is back, with show-and-tells, 

electronics workshops, and more. 


90 | magpicc | Raspberry Jam Event Calendar 


05. Raspberry Pi Club Los Alamos 

© Thursday 1 November 

Q9 Los Alamos Makers, Los Alamos, NM, USA 

» magpi.cc/DrSTtT 

A weekly club for people interested in the Raspberry Pi, 

where everyone is welcome. 

06. Leeds Raspberry Jam 

© Wednesday 7 November 

Q9 Dixons Unity Academy, Leeds, UK 

» magpi.cc/abNdVn 

Get hands-on with more digital making activities through 

the workshop. and a hackspace area to share projects. 

7 N 
FULL CALENDAR 


Get a full list of upcoming 
events for October and 
beyond here: 


rpf.io/jam 


07. Raspberry Jam Cambridge 

© Saturday 10 November 

Q9 Sancton Wood School, Cambridge, UK 

> magpi.cc/mXsjmA 

A great way to meet others and learn something 
new. Sessions are classroom based and run hourly. 
NN 
08. Raspberry Jam @ Pi Towers 

© Saturday 10 November 

Q9 37Hills Road, Cambridge, UK 

» magpi.cc/HDikif 

Visit the new Raspberry Pi offices for the 

November Raspberry Jam @ Pi Towers! 
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$ FIND OUT 
ABOUT JAMS 


Want a Raspberry Jam 


in your area? 
Want to start one? 


; Email Ben Nuttall about it: 
U d $ $ jam@raspberrypi.org 
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O We've highlighted some of the areas & 


in need of a Jam! Can you help out? 


Raspberry Jam advice: 


Fundraising 


á á e hand out free raffle tickets 
while we shake the donation 
tin. Then we pull winning y i 


tickets from a box and they win a prize we’ve F s 
had donated, like a HAT or something.” É 


Andrew Oakley - Cotswold Jam 


Every Raspberry Jam is entitled to apply for a 
Jam starter kit, which includes magazine issues, 
printed worksheets, stickers, flyers and more. 
Get the book here: magpi.cc/2q9DHfQ 
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Your 
Letters 


I really loved the ‘build a laptop’ 
article from the October issue 
and was hoping to get started on 
it, or something similar. I just 
wanted to know if I’d be able 

to use a Raspberry Pi 3 instead 
of a Raspberry Pi Zero? I have a 
Pi 3 spare and as it's a bit more 
powerful, I thought it might be 
better to use that! 


YW The laptop build last 
issue uses a Pi Zero, 
but you can use a Pi 3 
if you want to 


Paul via email 


The particular build in issue 74 of 
The MagPi uses a Pi Zero to make 
sure it's as small as possible 
- however, there's nothing 
stopping you using your Pi 3 
and a different 3D- printed 
case! A lot of the parts, 
build tips, and software 
instructions will be similar, 
as you still need to have it 
powered by a battery and use 
wireless input devices. 
Check out the section on 
upcycling laptops as well, as that 
may be very relevant to you! ll 


Contact us! 


> Twitter — (goTheMagPi 


» Facebook magpi.cc/facebook 


» Email 
» Online 


magpi@raspberrypi.org 
raspberrypi.org/forums 
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Highlighted 


I'm a 70-year-old total newbie 
to Pi and its projects, many of 
which I find fascinating. I do 
have a question, though. In 
The MagPi issue 74 ‘Raspberry 
Pi on x86 laptops’, under the 
heading ‘Burn and boot’, 

there is what looks like a link 
(magpi.cc/2joTqNm). 

I have tried many times to 
access this link for further info 
and am unable to? Please tell an 
old duffer what he needs to do. 


newbie70 from the forum 


This one of the ‘shortlinks’ that 
we’ve posted in the magazine, 
usually to make typing in the 
(otherwise longer) links a bit 
easier. You just need to copy 
them into your browser. If you’re 
having problems, make sure to 
re-read the link and check to see 
if you’re using the correct letters. 
If all else fails, all the links 

in The MagPi are clickable in the 
PDF version, so just load up the 
free PDF and click on it from 
in there. El 


P Send us 
your scary 
builds 


Spooky projects 


I enjoyed reading about 

the Halloween projects last 
issue! Will you be doing 

any highlights of reader 
projects at all this year? 

I have one that I might be 
able to send you if so, and 

I think there are a few others 
I could definitely point 
towards you... 


Derek via email 


We'd love to do a bit of a 
community Halloween project 
roundup this year, like we 
did last year! Issue 75 went to 
print a little too early for us 
to do it in time for Halloween, 
but check back in issue 76 
and we’ll definitely try to find 
some of the most petrifying Pi 
projects that are out there. 
Otherwise, you can always 
send them to the email 
address and other contact 
info above! Hl 
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Raspberry Pi is bringing back the Big 
Birthday Weekend again next year 


I had a lot of fun at the 


birthday Jams and Raspberry around the world will celebrate 

Fields last year. Is there any the Raspberry Pi’s birthday in 

info yet on if you’ll be doing coordinated Jams. Hopefully ^ 

anything like that again? none of them will be snowed off -—————U! — 
next year! = 

Stephanie on Twitter As for Fields, we don't have 

any news about that yet. We yer e 

Good timing - we've got info feel like the events team is still hd 

about Big Birthday Weekend recovering from the one in the 4 I 

2019 in the This Month in summer! We’ll let you know 

Raspberry Pi section. It’s a as soon as we can if there are Y 

similar deal to this year: Jams plans for another one! 


High Performance Audio For Raspberry Pi 


HAT modules 
integrated Digital-to-Analog Converter no soldering 


60W power, up to 8Ohm speakers needed 


Most sold Digital-to-Analog converter 
192khz/24bit offers high end sound quality 
also availabe as DAC+ light, DAC+ pro and DAC+ DSP 


What to built with HiFiBerry soundcards? 


visit hifiberry.com for complete product range, guides and inspirations 


[code] 
[club | 


Code Club is a network of volunteers and Sa 
educators who run free coding clubs for 
young people aged 9-13. 


We're always looking for people with coding skills to volunteer to 
run a club at their local school, library, or community centre. 


You can team up with friends or colleagues, you will be supported 
by someone from the venue, and we provide all the materials 
you'll need to help children get excited about digital making. 


To find out more, join us at 


"uw www.codeclubworld.org 


Code Club is part of the Raspberry Pi Foundation. Registered Charity Number 1129409 e 
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WIN 


PRESS START TO PLAY 


Picade retro 
aming consoles! 


We loved the new Picade in issue 74 of The MagPi 
(magpi.cc/74). With an authentic arcade controls and 
an eighties look straight from your nostalgia, it's the 
perfect retro gaming device for your home. 


Pimoroni has given us a Picade and 
Picade Console to give away, so enter In association with 


today for your chance to win one! [> M ( : iR o IN | 


Enter now at: magpi.cc/wi Learn more: magpi.cc/sAW 


Terms & Conditions 


Competition opens on 24 October 2018 and closes on 29 November 2018. Prize is offered to participants worldwide aged 13 or over, except employees of the Raspberry Pi Foundation, 
the prize supplier, their families or friends. Winners will be notified by email no more than 30 days after the competition closes. By entering the competition, the winner consents to any 
publicity generated from the competition, in print and online. Participants agree to receive occasional newsletters from The MagPi magazine. We don't like spam: participants’ details 
will remain strictly confidential and won't be shared with third parties. Prizes are non-negotiable and no cash alternative will be offered. Winners will be contacted by email to arrange 
delivery. Any winners who have not responded 60 days after the initial email is sent will have their prize revoked. This promotion is in no way sponsored, endorsed or administered by, 
or associated with, Instagram or Facebook. 
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Can you 
CoderDojo 


people to become 


CoderDojo is a global network of free, volunteer-led, 
project-based programming clubs for young people aged 
7-17. Here they can learn to code, build a website, create 
an app or a game, and explore technology in an informal, 
creative, and social environment. 


In order to run locally we need volunteers like you with 
a wide range of skills. You don’t have to be a coder to 
mentor. Dojos benefit from a mix of mentors providing 
support and encouragement to CoderDojo attendees. 


"A Tw 
Join us at coderdojo.com/volunteer 


i $20 0m 


The CoderDojo Foundation is Irish Registered Charity (524255) CHY20812 R b Pi 
and is part of the Raspberry Pi Foundation, UK registered charity 1129409 FETE aspberry F1 
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1 l The MagPi magazine is published 
DON'T MISS OUT! by Raspberry Pi Trading) Lid. 30 
Station Road, Cambridge, CB1 2JH. 
C - The publisher, editor, and contributors 
m ag p | e. cc/s u bs C ri be accept no responsibility in respect 
of any omissions or errors relating to 
goods, products, or services referred 
to or advertised in the magazine. 
TWITTER @TheMagPi Except where otherwise noted, 
content in this magazine is licensed 
E " under a Creative Commons 
FACEBOOK fb.com/MagPiMagazine g Attribution-NonCommercial- 


ShareAlike 3.0 Unported 


Sz 
" H RaspberyPi | (CC BY-NC-SA 3.0). 
EMAIL magpi@raspberrypi.org PRESS] joc RM 


by 


magpicc | 97 


ME Magi | THE FINAL WORD 


Making magazines 


Eben Upton on building physical products 


nce, I thought running a 
Q hardware company would be 
all about making hardware. 
Turns out, it's actually about learning 
new things. 

When we started back in 2006,I 
was an embedded software engineer: 
I knew how to crank out high- 
performance C and assembler for 
mobile phones, games consoles, 
and microcontrollers, but absolutely 
nothing about how to design chips or 
PCBs, still less how to build millions 
of units of a physical product and get 
them to customers all over the world. 
Still, i? s amazing what you can pick 
p if you hang out with bright people. 


(= 


Once upon a time 
Around the time I was building the 
first Raspberry Pi prototype (on 
Veroboard!) in 2006, I joined Broadcom 
as a software engineer in the video and 
graphics team, and got my first taste 
of hardware design. Although I was 
supposed to stick to writing firmware, 
every software engineer had access to 
the Verilog source code for the chip 
that we were working on. Nobody in 
their right mind would let me write 
a module from scratch, but if I could 
find a bug, and get my fix signed off 
by the real hardware engineer in the 
next cubicle (future Raspberry Pi COO 
James Adams), my code might make it 
into the chip. 

A couple of years later, we started 
work on the first real Raspberry Pi 
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design. There's a vast difference 
between soldering down some PDIP 
chips on a piece of Veroboard, with 
signals running at a few tens of 
megahertz, and escaping high-speed 
signals like HDMI from a fine- pitch 
BGA on a six-layer PCB. But I got 

to watch over my co-founder Pete 
Lomas’s shoulder while he laid 


do this, and equally insistent that 
we should recruit Russell Barnes as 
editor. After five digital-only issues, 
the magazine made a triumphant 
return to print in August 2015, and 
has never looked back. Russell has 
surrounded himself with an amazing 
team, including Lucy and Rob here 
at The MagPi, and Ben and Andrew 


m | spend a wholly inappropriate amount of time 
thinking about our publishing business @ 


out what would become the classic 
Raspberry Pi Model B. And six 
months later, I got to watch Mike 
Buffham (future Raspberry Pi Director 
of Product Management) figure 

out how to build Pete's design in 
volume at Sony. 

I'll never be able to write Verilog 
like James, lay out a PCB like Pete, 
or juggle a supply chain like Mike. 
But hanging out with them taught 
me more about hardware, and 
about business, than any course 
or textbook could. 


Going to print 

Which brings me to publishing. At the 
start of 2015, we had the opportunity 
to take up the reins of The MagPi 

from Ash, Will, Ian, and Aaron, who 
had been running it since 2012. Liz 
was quite insistent that we should 


at HackSpace, and together they've 
done amazing things. 

I spend a wholly inappropriate 
amount of time thinking about our 
publishing business. In part, that's 
because it's further from my comfort 
zone than anything else we do: 
there's just so much for me to learn 
here. But it's also because even I can 
see the scale of the opportunity ahead 
of us. I think you're going to love 
what the team has planned over the 
next couple of years, but for now let's 
raise a glass to the first 75 issues of 
The MagPi, and to the next 75. H 


Eben Upton 


Eben is the creator of Raspberry Pi and a 
co-founder of the Raspberry Pi Foundation. 
He has extraordinary travel booking skills. 


magpi.cc/eben 


THE Official 
RASPBERRY PI 
EGINNERS BOOK 


THE EASY WAY! 


Pi Zero W computer 


Official case with three covers 
USB and HDMI adapters 

8GB microSD card 

116-page beginner’s book 
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The pocket-sized desktop computer! _____— g 
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Build your own credit card 
sized computer 


Get started with programming 
Setup a Media Center 
Make simple electronic circuits 


Raspberry Pi board and case 


EON Supply and HDMI cable 
oc rogrammed Memory Card 
IN 40 electronic Parts 
'aspberry pi Kit For Dummies Booki 
et 


Ree swe ey Pr 


FOR 


DUMM A Wiley Brand 
Available in Europe 


Available for worldwide shipping at: through RS Components 


$89” £69? 


US DOLLARS EXCLUDING VAT 


Raspberry Pi is a registered trademark of the Raspberry Pi Foundation. 
For Dummies and the Dummies Man logo are trademarks or registered 
trademarks of John Wiley & Sons, Inc. Used under license. RS logo is 

a registered trademark of RS Components Ltd. CanakKit is a registered 
trademark of Cana Kit Corporation. 
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